SuperAPI AI 工具集

mcp-observatory

MCP Observatory 是一款面向 MCP(Model Context Protocol)服务器的 CI 原生安全测试工具,主要服务于自行开发 MCP 服务器的团队。它可以在开发阶段对已配置的 MCP 服务器进行扫描:发现服务器、检查其能力、实际调用安全工具、检测 schema 漂移,并根据项目所用语言、框架、数据库和云服务商推荐缺失的 MCP 服务器。工具还提供攻击模拟、安全评分、SARIF/HTML/Markdown 报告、GitHub Code Scanning 集成,以及 record/replay/verify 回归测试流程。它本身也可作为 MCP 服务器运行,让 AI 智能体自主测试和监控其他 MCP 服务器。本地使用和本地 CI 保持免费,托管快照有免费额度,Individual Pro 为每月 29 美元。

访问官网

工具介绍

用途

MCP Observatory 是面向正在构建自定义 MCP(Model Context Protocol)服务器的团队的 CI 原生安全工具。MCP 服务器正在成为生产依赖,如果智能体依赖它们,团队就需要在故障到达用户之前,发现损坏的工具、不安全的 schema、schema 漂移、响应缓慢以及安全隐患。Observatory 用于在开发阶段进行测试,捕获 schema 漂移,模拟攻击,并在智能体依赖你的服务器之前生成合规证据。

主要能力

  • 能力检查:连接服务器并验证 tools、prompts 和 resources 是否正确响应。
  • 工具调用:不止于列出工具,而是实际调用安全工具(无必需参数 / readOnlyHint),并报告哪些可用、哪些会崩溃。
  • Schema 漂移检测:对两次运行进行差异比较,显示新增/删除字段、类型变更和破坏性参数变更。
  • 服务器推荐:扫描项目中的语言、框架、数据库和云服务商,交叉比对 MCP 注册表,推荐缺失的服务器。
  • 安全扫描:分析工具 schema 中的危险模式,包括 shell 注入面、宽泛的文件系统访问、缺失认证以及响应中的凭据泄露。
  • Record / replay / verify:捕获实时会话,在 CI 中离线回放并验证无变化,类似 MCP 的 VCR。
  • 回归监控:按间隔重新运行检查,在发生变化时告警。
  • CI 集成:一条命令完成 CI 设置(setup-ci --all);支持 GitHub PR 评论、GitHub Code Scanning SARIF、GitLab SAST 报告。
  • MCP 回执与风险图:打包目标、证据、裁决、行动和复现命令;按能力边界、回执状态、CI 姿态和推荐行动对服务器分组。
  • MCP 服务器模式:将一个 AI 工具作为 MCP 服务器加入后,你的 AI 智能体可自主测试、诊断和监控其他 MCP 服务器,获得 10 个工具。

使用方式

安装方式:

npx -y @kryptosai/mcp-observatory@latest
brew tap kryptosai/mcp-observatory https://github.com/KryptosAI/mcp-observatory && brew install mcp-observatory
docker pull ghcr.io/kryptosai/mcp-observatory:latest
curl -fsSL https://raw.githubusercontent.com/KryptosAI/mcp-observatory/main/scripts/install.sh | sh

首次扫描:在项目文件夹中运行上述 npx 命令,它会下载 Observatory 并检查第一个已配置的 MCP 服务器;没有配置服务器时会使用内置示例。仅尝试示例:

npx -y @kryptosai/mcp-observatory@latest demo --example

深入检查(同时调用安全工具验证是否实际运行):

npx -y @kryptosai/mcp-observatory@latest test --invoke-tools

测试指定服务器:

npx -y @kryptosai/mcp-observatory@latest scan --target "npx -y my-mcp-server"

生成完整 CI 工作流:

npx -y @kryptosai/mcp-observatory@latest setup-ci --all --command "npx -y my-mcp-server" --sarif

保存一次免费托管快照(可选):在同一项目文件夹中运行 npx -y @kryptosai/mcp-observatory@latest cloud upload,打开终端打印的验证链接,确认代码,用 GitHub 连接,然后返回终端等待 Upload complete 并打开仪表盘链接。

作为 MCP 服务器加入 Claude Code:

npx -y @kryptosai/mcp-observatory@latest serve

默认拒绝连接:npx -y @kryptosai/mcp-observatory@latest protect 会重写每个发现的客户端配置(Cursor、Claude、VS Code、.mcp.json 等);撤销:protect --undo。HTTP/SSE 服务器不受影响。

运行时默认拒绝:npx -y @kryptosai/mcp-observatory@latest enforce --start-proxy 根据扫描写入 Seatbelt 策略并启动代理。

扫描时会在以下位置查找 MCP 配置:~/.claude.json(Claude Code)、~/Library/Application Support/Claude/claude_desktop_config.json(Claude Desktop,macOS)、%APPDATA%/Claude/claude_desktop_config.json(Claude Desktop,Windows)、当前目录的 .claude.json 和 .mcp.json。

扫描宿主机上的服务器需要网络,对本地文件还需要卷挂载(-v "$PWD:$PWD" -w "$PWD")。

适用场景

  • 自行开发 MCP 服务器、需要在 CI 中做回归测试和安全检查的团队。
  • 安全与平台团队:MCP 服务器正成为 AI 软件供应链的一部分,需要在关键工作流依赖前获得可靠、可测试、可审计的工具。
  • 需要为 MCP 仓库添加公开兼容性/安全信号徽章的维护者。

限制

  • 需要交互式 OAuth 的服务器(如 Google Drive)需预先认证后 Observatory 才能连接。
  • 自定义 WebSocket 传输(如 BrowserTools MCP)不受支持。
  • 少数服务器在 init 前超时或关闭,详见已知问题和兼容性文档。
  • MCP 服务器模式下为防止提示注入:命令白名单仅允许 npx、node、python、python3、uvx、docker、deno、bun 作为基础可执行文件;文件读取工具限制在 runs/cassettes 目录;不支持任意执行。

收费相关

本地扫描和本地 CI 保持免费。托管快照免费包含一个目标、最新快照、七天保留和每月十次上传。Individual Pro 为每月 29 美元,用于 10 个目标、90 天历史、托管 CI 摄取或托管 HTTP 扫描。生产支持方面,MCP Release Gate Pilot 的固定公开入门报价为 15,000 美元,覆盖 1-3 个关键 MCP 服务器、十个工作日;更广泛的工作在发布决策后确定范围。

补充说明

Observatory 在展示收集通知后使用按司法辖区感知的产品遥测。可用 telemetry preview 查看确切字段,用 telemetry status 查看当前策略,或用 telemetry disable、MCP_OBSERVATORY_TELEMETRY=0、DO_NOT_TRACK=1 停止收集。仓库以 MIT 许可开源。