cyberchef-api-mcp-server

MCP.Pizza Chef: slouchd

The CyberChef API MCP Server connects MCP clients with the CyberChef Server API, enabling execution of complex data transformation recipes and operations. It exposes CyberChef's extensive toolset, including operation categories, specific operations, and batch processing capabilities, allowing LLMs to perform automated encoding detection, data baking, and multi-step data manipulations seamlessly within MCP workflows.

Use This MCP server To

Execute CyberChef recipes to transform or decode input data Retrieve CyberChef operation categories for dynamic tool selection List operations within CyberChef categories for precise processing Batch process multiple inputs with CyberChef recipes Automatically detect data encoding and apply suitable operations

README

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

πŸͺͺ License

MIT License

cyberchef-api-mcp-server FAQ

How does the CyberChef API MCP Server integrate with MCP clients?
It exposes CyberChef's API endpoints as MCP resources and tools, allowing clients to invoke data transformation operations directly.
Can I run batch data transformations using this MCP server?
Yes, the batch_bake_recipe tool supports executing recipes on multiple inputs simultaneously.
What is the 'magic operation' in CyberChef exposed by this server?
It automatically detects data encoding and suggests or applies appropriate CyberChef operations.
How do I get the list of available CyberChef operations?
Use the get_cyberchef_operations_categories resource to fetch categories, then get_cyberchef_operation_by_category to list operations.
Is this MCP server limited to specific LLM providers?
No, it is provider-agnostic and works with any LLM/MCP client like OpenAI, Claude, or Gemini.
What types of data transformations can I perform?
You can perform encoding/decoding, encryption, compression, data format conversions, and more using CyberChef's extensive operations.
How secure is the data processed through this MCP server?
Security depends on the deployment environment; the server acts as a proxy to CyberChef API without storing data persistently.
Can I customize or extend the operations available?
Operations are based on CyberChef Server capabilities; extending requires updating the underlying CyberChef Server.