CyberChef API MCP Server

1# CyberChef API MCP Server
2 
3This model context protocol (MCP) server interfaces with the [CyberChef Server](https://github.com/gchq/CyberChef-server) API. Allowing you to use any LLM/MCP client of your choosing to utilise the tools and resources within CyberChef.
4 
5🧰 Available Tools and Resources
6---
7- `get_cyberchef_operations_categories`: __resource__ - gets updated Cyber Chef categories for additional context / selection of the correct operations
8- `get_cyberchef_operation_by_category`: __resource__ - gets list of Cyber Chef operations for a selected category
9- `bake_recipe`: __tool__ - bake (execute) a recipe (a list of operations) in order to derive an outcome from the input data
10- `batch_bake_recipe`: __tool__ - bake (execute) a recipe (a list of operations) in order to derive an outcome from a batch of input data
11- `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
12 
13📝 Usage
14---
15Start the server using the default stdio transport and specifying an environment variable pointing to a CyberChef API
16 
17```bash
18CYBERCHEF_API_URL="your-cyberchef-api-url" uv run cyberchef_api_mcp_server
19```
20 
21🧑‍💻Usage (Development)
22---
23Start the server and test it with the MCP inspector
24 
25```bash
26uv add "mcp[cli]"
27mcp dev server.py
28```
29 
30📚 Client Configuration
31---
32The following commands will generate a client configuration file, the location will depend on your operating system
33 
34```bash
35uv add "mcp[cli]"
36mcp install server.py --name "CyberChef API MCP Server"
37```
38 
39> [!TIP]
40> After running the above command you can then tweak the client configuration to include the environment variable for the CyberChef API URL
41 
42```json
43{
44 "mcpServers": {
45   "CyberChef API MCP Server": {
46     "command": "uv",
47     "args": [
48       "run",
49       "--with",
50       "mcp[cli]",
51       "--directory",
52       "cyberchef-api-mcp-server/cyberchef_api_mcp_server/",
53       "mcp",
54       "run",
55       "server.py"
56     ],
57     "env": {
58       "CYBERCHEF_API_URL": "your-cyberchef-api-url"
59     }
60   }
61 }
62}
63```
64 
65🔍 Demo
66---
67Using the MCP server in this example use case, the following prerequisites apply: 
68- You must have Claude desktop installed
69- Have a running CyberChef API instance or one you are able to use
70 
71Here is a basic prompt being solved using the MCP server tools:
72<img width="1511" src="https://github.com/user-attachments/assets/657f52b3-43eb-4c3b-94f1-289fc12817b2" />
73 
74🙇 References
75---
76- [CyberChef](https://github.com/gchq/CyberChef)
77- [CyberChef Server](https://github.com/gchq/CyberChef-server)
78- [Model Context Protocol](https://github.com/modelcontextprotocol)
79- [FastMCP](https://github.com/jlowin/fastmcp)
80 
81🪪 License
82---
83MIT License
84