Metadata-Version: 2.4
Name: iflow-mcp-lazy-importer-die
Version: 0.1.0
Summary: MCP server for Detect It Easy (DIE) executable file analysis
Project-URL: Homepage, https://github.com/lazy-importer/D.I.E-MCP
Project-URL: Repository, https://github.com/lazy-importer/D.I.E-MCP
License-File: LICENSE
Requires-Python: >=3.8
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=0.1.2
Requires-Dist: pydantic>=2.0.0
Requires-Dist: starlette>=0.31.0
Requires-Dist: uvicorn>=0.23.0
Description-Content-Type: text/markdown

# DIE (Detect It Easy) MCP Server

## Overview

This project provides an MCP (Model Context Protocol) server that allows AI agents to use Detect It Easy (DIE) to analyze executable files. The server acts as a bridge between AI models and the DIE command-line tool.

## Server Structure

- `die_server.py` - Main MCP server implementation
- `requirements.txt` - Project dependencies
- `examples/` - Optional example clients and usage demonstrations

## Quick Start

1. Install DIE (Detect It Easy) command-line tool
2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```
3. Run the server:
   ```bash
   python die_server.py --die-path "path/to/diec.exe" --transport stdio
   ```

## Server Options

- `--transport {stdio,sse}`: Transport mode (stdio or sse). Default: stdio
- `--host HOST`: Host to bind to (for SSE mode). Default: 0.0.0.0
- `--port PORT`: Port to listen on (for SSE mode). Default: 8080
- `--die-path DIE_PATH`: Path to the DIE command-line executable (diec.exe)

## Available MCP Tools

The server exposes these DIE functionalities through MCP:

### analyze_file
Analyzes an executable file with DIE.
```python
{
    "file_path": "path/to/file",
    "json_output": true,
    "deep_scan": false,
    "entropy": false,
    "verbose": false
}
```

### show_special_info
Gets special file info for a specific method.
```python
{
    "file_path": "path/to/file",
    "method": "Hash"  # or other methods like "Entropy", "Info"
}
```

### list_available_methods
Lists all available special methods for a file.
```python
{
    "file_path": "path/to/file"
}
```

## Example Usage

See the `examples/` directory for sample clients and usage demonstrations.