用途
CyberChef-MCP 是一个模型上下文协议（MCP）服务器，将 GCHQ 的 CyberChef（“网络瑞士军刀”）核心 Node.js API 封装为 MCP 工具。其目标是在自然语言的 AI 意图与确定性的数据处理之间架起桥梁，让 AI 助手（如 Claude、Cursor AI 等）能够原生调用 CyberChef 的 504 项数据操作，包括加密、编码、压缩与取证分析。
主要能力
- 将全部 504 项 CyberChef 操作暴露为 MCP 工具，覆盖加密、编码、压缩、取证等场景。
- 提供核心“万能”工具 cyberchef_bake，用于执行完整 CyberChef 配方（操作链），适合多步转换，例如“先 Base64 解码，再 Gunzip，再格式化 JSON”。
- 提供 cyberchef_search，帮助 AI 按关键词发现操作及其描述。
- 通过索引式工具发现机制降低 tools/list 体积：默认返回 23 个工具（15,620 字节），而非 546 个工具（427,123 字节）；可通过 cyberchef_categories → cyberchef_list_operations → cyberchef_describe_operation 逐层到达任意操作，或用 cyberchef_search 按关键词查找，再用 cyberchef_bake 按名称执行。
- 可选工具面：CYBERCHEF_TOOL_SURFACE=curated（120 个工具，109,548 字节）或 all（全部 546 个工具，427,123 字节）。
- 配方管理（v1.6.0 起）：10 个工具，用于保存、组织与复用多操作工作流，包括 cyberchef_recipe_create、cyberchef_recipe_get、cyberchef_recipe_list、cyberchef_recipe_update、cyberchef_recipe_delete、cyberchef_recipe_execute、cyberchef_recipe_export、cyberchef_recipe_import、cyberchef_recipe_validate、cyberchef_recipe_test。
- 高级功能（v1.7.0 起）：cyberchef_batch（并行或顺序执行多个操作）、cyberchef_telemetry_export（选择性加入的隐私优先使用分析）、cyberchef_cache_stats / cyberchef_cache_clear（缓存检查与管理）、cyberchef_quota_info（资源配额与使用跟踪）。
- 分析工具（非操作类）：从最初四个扩展至十九个，包括 cyberchef_xor_key_length、cyberchef_cyclic_pattern、cyberchef_hash_identify、cyberchef_rsa_attack；v3.3.0 新增古典密码、crib dragging、熵扫描、哈希破解与统计、JWT 弱点、明文评分、多密钥 RSA、替换密码与维吉尼亚破解、时间戳识别、语料对比等；v3.4.0 增加 cyberchef_ecdsa_recover；v3.8.0 增加 cyberchef_cert_chain；v3.11.0 增加 cyberchef_pqc_identify。自 v4.1.0 起通过 cyberchef_analyse({tool, arguments}) 访问。
- 提示与资源（v2.2.0 起）：五个工作流提示（analyse-unknown-data、extract-iocs、deobfuscate-script、identify-hash、decode-chain），以及保存的配方作为可读资源 recipe://<id>。
- 图像与音频返回（v2.2.0 起）：生成二维码、渲染图像等返回 MCP 图像内容块；播放媒体返回音频块；其他二进制保持字节无损的 latin1 文本，或通过 CYBERCHEF_BINARY_OUTPUT=base64 返回 base64。
- 工具注解（v2.2.0 起）：每个工具均带 readOnlyHint、destructiveHint、idempotentHint、openWorldHint 与可读标题，便于客户端跳过审批。
使用方式
- 运行 MCP 服务器后，AI 助手即可调用上述工具。可通过 stdio、Streamable HTTP 或 socket（Unix 域套接字或回环 TCP，CYBERCHEF_TRANSPORT=socket）三种传输方式接入。
- 协议修订版本 2026-07-28（v2.3.0 起）在 stdio 与 HTTP 上同时服务，并与 2025 时代版本共存，由同一组处理器处理，已有客户端不受影响。
- HTTP 上支持 OAuth 2.1 认证（v2.5.0 起）：作为 OAuth 2.1 资源服务器，支持 RFC 9728 受保护资源元数据、基于 JWKS 的持有者验证、RFC 8707 受众绑定；基于作用域的 RBAC 含 cyberchef:read、cyberchef:write、cyberchef:network 三个作用域；默认关闭，除非设置 CYBERCHEF_AUTH_ISSUER，且不应用于 stdio。
- 多租户（v2.5.0 起）：操作缓存、配方存储、并发池与审计轨迹按租户隔离，租户来自已验证令牌的声明（CYBERCHEF_TENANT_CLAIM）。默认关闭。
- 可观测性（v2.7.0 起）：可选的 Prometheus 端点 /metrics（20 个指标族，默认关闭）、遵循 MCP 语义约定的 OpenTelemetry span、日志行带 trace_id / span_id；工具参数从不记录。
- 离线模式：设置 CYBERCHEF_OFFLINE=true 适用于气隙主机，504 项操作中 502 项本就不访问网络，该开关对另外两项按配方进行失败关闭检查。
- 部署：v2.6.0 起提供 Helm chart 与 Compose 文件，含存活/就绪/启动探针与滚动更新期间不丢请求的排空机制；镜像同时发布 linux/arm64 与 linux/amd64，体积从 643 MB 降至 453 MB。
- 启动性能：v2.6.0 起启动约 185 毫秒（此前约 1.3 秒），505 操作桶仅由三个需要的工具加载，普通操作调用只加载所运行的那一个操作。
适用场景
- AI 辅助的网络安全分析与取证：识别哈希、破解古典密码、分析加密数据、提取 IOC、反混淆脚本。
- 复杂多步数据转换：通过 cyberchef_bake 执行 Base64 解码、Gunzip、JSON 格式化等链式操作。
- 需要保存与复用工作流的场景：配方管理工具。
- 企业级部署：OAuth 2.1 认证、多租户隔离、审计日志、配额管理、可观测性与 Kubernetes 部署。
限制
- 网页 UI 组件已移除（88 个文件，约 19,260 行），不适用于 MCP 服务器。
- 与上游 GCHQ/CyberChef 为单向同步（仅拉取），自 v2.0.0 起整体为 GPL-3.0-or-later，MCP 层变更无法回馈至 Apache-2.0 的上游。
- 迁移工具已在 v4.0.0 中移除（cyberchef_migration_preview、cyberchef_deprecation_stats 与 cyberchef-migrate 二进制）；v1 格式配方无需迁移。
- 无 WebSocket 传输，因为 MCP 未定义该传输方式。
- 无插件加载器，因为 node:vm 不构成安全边界（经实测而非假设，见 ADR 0002）。
- socket 传输不携带认证，非回环绑定除非显式允许否则被拒绝，Unix 套接字以 0600 创建。
- OAuth 与多租户默认关闭，需显式配置；未配置认证而配置多租户将导致启动错误。
- 分析工具无法通过普通操作或 cyberchef_bake 表达，需通过专用工具访问。
- 其他未在资料中明确的功能、收费、价格、平台或效果暂未提供。
