# 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.