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