Skip to content

slouchd/cyberchef-api-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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

About

CyberChef API MCP Server βœ¨πŸ§‘β€πŸ³

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published