用途
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 许可开源。