D.i.e MCP

🚀 DIE (Detect It Easy) MCP Server

This project offers an MCP (Model Context Protocol) server enabling AI agents to utilize Detect It Easy (DIE) for analyzing executable files. The server serves as a bridge between AI models and the DIE command - line tool.

🚀 Quick Start

1. Install the DIE (Detect It Easy) command - line tool.
2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the server:

   python die_server.py --die-path "path/to/diec.exe" --transport stdio
   

✨ Features

This project provides an MCP server that exposes DIE's functionalities to AI agents, facilitating the analysis of executable files.

📦 Installation

1. Install the DIE (Detect It Easy) command - line tool.
2. Install project dependencies:

   pip install -r requirements.txt
   

💻 Usage Examples

Basic Usage

The server exposes several DIE functionalities through MCP. Here are some examples:

analyze_file

Analyzes an executable file with DIE.

{
    "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.

{
    "file_path": "path/to/file",
    "method": "Hash"  # or other methods like "Entropy", "Info"
}

list_available_methods

Lists all available special methods for a file.

{
    "file_path": "path/to/file"
}

Advanced Usage

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

📚 Documentation

Server Structure

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

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