Chepy MCP Service (CyberChef like Python library)

chepy-mcp

Chepy 库函数的 MCP 服务

概述

本项目将强大的 Chepy 数据转换库作为 MCP（Model Context Protocol） 服务开放。你可以通过一个灵活的 API 访问 Chepy 的工具（例如编码、解码和数据处理）：bake 管道工具，其设计灵感来自 CyberChef。

功能

• 单一管道工具（bake）：在单个请求中串联一个或多个 Chepy 操作，并为每个操作指定参数
• Chepy 配方 JSON 格式：使用 Chepy 自带的配方序列化格式描述管道，因此可与 Chepy 的导入/导出和 CLI 工具兼容
• 资源端点：发现所有可用的 Chepy 操作及其签名
• 基于 unittest 的测试套件，可进行稳健验证

安装

1. 如果尚未安装 uv，请先安装。

   $ curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 克隆仓库：

   git clone https://github.com/nebucaz/chepy-mcp.git
   cd chepy-mcp
   

3. 安装依赖：

   uv sync
   

运行

使用以下命令运行服务：

$ uv run src/server.py

使用方法

Chepy 配方 JSON 格式

bake 工具要求使用 Chepy 配方 JSON 格式编写管道：

{
  "input": "hello world",
  "recipe": [
    {"function": "to_base64", "args": {}},
    {"function": "from_base64", "args": {}}
  ]
}

• recipe 列表中的每个步骤都是一个对象，包含 function（Chepy 操作名称）和 args（该操作的参数字典）。
• 此格式与 Chepy 自带的配方导入/导出和 CLI 工具完全兼容。

响应会指明输出是文本还是二进制：

{
  "type": "text",
  "data": "hello world"
}

发现可用操作

获取资源端点，以查看所有可用的 Chepy 操作、参数签名和说明：

• 资源 URI： resource://chepy_operations

响应示例：

{
  "to_base64": {
    "signature": "(alphabet: str = 'standard')",
    "description": "Encode the input string to base64"
  },
  "from_base64": {
    "signature": "(alphabet: str = 'standard', remove_non_alpha: bool = True)",
    "description": "Decode base64 encoded string"
  }
}

扩展

• 所有 Chepy 操作均可通过管道工具使用；无需添加单独的封装。
• 可根据需要在 tests/ 目录中添加更多测试。

注意事项

• bake 工具会自动检测输出是文本还是二进制，并将二进制编码为 base64。
• 有效操作及其参数列表，请参阅 resource://chepy_operations 资源。
• 为了实现最大的灵活性和可维护性，仅开放 bake 工具和 Chepy 操作资源。
• 管道格式与 Chepy 自带的配方序列化和 CLI 工具完全兼容。

许可证

MIT

---