Cyberchef Api MCP Server

🚀 CyberChef API MCP Server

This Model Context Protocol (MCP) server interfaces with the CyberChef Server API. It allows you to leverage the tools and resources in CyberChef using any LLM/MCP client of your choice.

✨ Features

Available Tools and Resources

• get_cyberchef_operations_categories: Resource - Get updated Cyber Chef categories for more context/selecting the correct operation.
• get_cyberchef_operation_by_category: Resource - Get a list of Cyber Chef operations based on the selected category.
• bake_recipe: Tool - Bake (execute) a recipe (list of operations) to derive results from input data.
• batch_bake_recipe: Tool - Bake (execute) a recipe (list of operations) to derive results from a batch of input data.
• perform_magic_operation: Tool - Perform CyberChef's "Magic" operation, which aims to automatically detect how your data is encoded and determine the operations that can be used to decode it.

📦 Installation

Usage

Start the server using the default stdio transport and specify an environment variable pointing to the CyberChef API.

CYBERCHEF_API_URL="your-cyberchef-api-url" uv run cyberchef_api_mcp_server

For Developers (Development)

Start the server and test it in the MCP inspector.

uv add "mcp[cli]"
mcp dev server.py

Client Configuration

The following command will generate a client configuration file, and the location depends on your operating system.

uv add "mcp[cli]"
mcp install server.py --name "CyberChef API MCP Server"

💡 Usage Tip

After running the above command, you can adjust the client configuration to include the environment variable for the CyberChef API URL.

{
 "mcpServers": {
   "CyberChef API MCP Server": {
     "command": "uv",
     "args": [
       "run",
       "--with",
       "mcp[cli]",
       "--directory",
       "cyberchef-api-mcp-server/cyberchef_api_mcp_server/",
       "mcp",
       "run",
       "server.py"
     ],
     "env": {
       "CYBERCHEF_API_URL": "your-cyberchef-api-url"
     }
   }
 }
}

💻 Usage Examples

Basic Usage

Use this MCP server in the following example use cases with the following prerequisites:

• You must have Claude Desktop installed.
• A running CyberChef API instance or an available instance.

Use the MCP server tools in this basic prompt:

📚 Documentation

References

• CyberChef
• CyberChef Server
• Model Context Protocol
• FastMCP

📄 License

This project is licensed under the MIT License.