CyberChef API MCP Server

by slouchd

42 stars
243 downloads
Not rated
GitHub

About

CyberChef API MCP Server is a Model Context Protocol (MCP) server that interfaces with the CyberChef Server API. It allows any LLM or MCP client to use the tools and resources within CyberChef.

Details

Author
slouchd
GitHub stars
42
Downloads
243
Categories
Developer Tools

- Provides resources for listing CyberChef operation categories
- Provides resources for listing operations by category
- Offers a tool to execute a single recipe on input data
- Offers a tool to execute a recipe on a batch of inputs
- Offers a magic tool to auto‑detect encoding and suggest operations

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name CyberChef API MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Start the server by setting the CYBERCHEF_API_URL environment variable to a running CyberChef API instance and running uv run cyberchef_api_mcp_server. For development, use mcp dev server.py. After installation, a client configuration file can be generated and tweaked to include the environment variable.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cyberchef api mcp server": {
            "cyberchef-api-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "cyberchef_api_mcp_server"
                ],
                "env": {
                    "CYBERCHEF_API_URL": "your-cyberchef-api-url"
                }
            }
        }
    }
}

McpServers

{
    "cyberchef-api-mcp-server": {
        "command": "uv",
        "args": [
            "run",
            "cyberchef_api_mcp_server"
        ],
        "env": {
            "CYBERCHEF_API_URL": "your-cyberchef-api-url"
        }
    }
}

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.