slouchd/cyberchef-api-mcp-server

This model context protocol (MCP) server interfaces with the CyberChef Server API. Allowing you to use any LLM/MCP client of your choosing to utilise the tools and resources within CyberChef.

🧰 Available Tools and Resources

• get_cyberchef_operations_categories: resource - gets updated Cyber Chef categories for additional context / selection of the correct operations
• get_cyberchef_operation_by_category: resource - gets list of Cyber Chef operations for a selected category
• bake_recipe: tool - bake (execute) a recipe (a list of operations) in order to derive an outcome from the input data
• batch_bake_recipe: tool - bake (execute) a recipe (a list of operations) in order to derive an outcome from a batch of input data
• perform_magic_operation: tool - perform CyberChef's magic operation which is designed to automatically detect how your data is encoded and which operations can be used to decode it

📝 Usage

Start the server using the default stdio transport and specifying an environment variable pointing to a CyberChef API

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

🧑‍💻Usage (Development)

Start the server and test it with the MCP inspector

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

📚 Client Configuration

The following commands will generate a client configuration file, the location will depend on your operating system

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

[!TIP] After running the above command you can then tweak 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"
     }
   }
 }
}

🔍 Demo

Using the MCP server in this example use case, the following prerequisites apply:

• You must have Claude desktop installed
• Have a running CyberChef API instance or one you are able to use

Here is a basic prompt being solved using the MCP server tools:

🙇 References

• CyberChef
• CyberChef Server
• Model Context Protocol
• FastMCP

🪪 License

MIT License