Repolode
KryptosAI

KryptosAI/mcp-observatory

面向 MCP 服务器的开源安全与回归测试 CLI,支持 schema 漂移检测、安全攻击模拟和 SARIF 输出。

Star
120
Fork
15
未关闭 Issue
20
最近提交
3天前

这是什么?

MCP Observatory 是一个命令行工具,用于在 AI 智能体依赖 MCP(Model Context Protocol)服务器之前对其进行测试。它会连接服务器,检查工具、提示词和资源,可选调用安全的只读工具以确认其能正常运行,并给出 0 到 100 分的健康评分和等级。

该工具侧重于适合放入 CI 的回归与安全检查。它可以把服务器会话录制为 cassette 文件并离线回放,用录制内容校验在线服务器,还能对比两次运行结果,找出新增或删除的字段以及破坏性的参数变更。工具 schema 也会被分析,识别 shell 注入、过宽的文件系统访问和凭据泄露等风险模式。

检测结果可输出为 SARIF 格式,供 GitHub Code Scanning 使用;setup-ci 命令可生成 GitHub Actions 或 GitLab CI 工作流。项目本身也能作为 MCP 服务器运行,使智能体可以调用它对其他服务器进行检查。运行需要 Node.js 20 或更高版本,可通过 npx、Homebrew 或 Docker 安装。

核心功能

  • 01检查 MCP 服务器的工具、提示词和资源,并给出 0-100 的健康评分。
  • 02通过对比两次运行结果检测 schema 漂移,包括新增、删除和破坏性变更。
  • 03将会话录制为 cassette 文件,并支持离线回放和校验。
  • 04执行安全攻击模拟,标记存在风险的工具 schema 模式。
  • 05输出 SARIF 格式结果,并可生成 GitHub Actions 或 GitLab CI 工作流。
  • 06可作为 MCP 服务器运行,让智能体检测其他 MCP 服务器。

适用场景

  • 为自研 MCP 服务器的 CI 流水线增加安全和兼容性检查。
  • 在依赖某个服务器的智能体出错之前,发现工具 schema 的意外变更。
  • 安装第三方 MCP 服务器前,检查其工具是否存在风险模式。
  • 在 Pull Request 中将 MCP 检测结果上传到 GitHub Code Scanning。

快速上手

  1. 1

    使用 npx 运行首次扫描

    npx -y @kryptosai/mcp-observatory@latest
  2. 2

    测试指定的 MCP 服务器

    npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything
  3. 3

    打开本地仪表板查看结果

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

使用前须知

  • 需要 Node.js 20 或更高版本。
  • 部分高级功能(如 ClearFrame 工作流)依赖仅支持 Apple Silicon 的 Mac 应用。

收录于专题

标签

常见问题

mcp-observatory 是什么?
面向 MCP 服务器的开源安全与回归测试 CLI,支持 schema 漂移检测、安全攻击模拟和 SARIF 输出。 MCP Observatory 是一个命令行工具,用于在 AI 智能体依赖 MCP(Model Context Protocol)服务器之前对其进行测试。它会连接服务器,检查工具、提示词和资源,可选调用安全的只读工具以确认其能正常运行,并给出 0 到 100 分的健康评分和等级。
mcp-observatory 可以免费使用吗?用的什么许可证?
mcp-observatory 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-observatory 还在维护吗?
活跃维护中。mcp-observatory 最近一次提交是在 2026年11月4日。
mcp-observatory 适合用来做什么?
为自研 MCP 服务器的 CI 流水线增加安全和兼容性检查。 在依赖某个服务器的智能体出错之前,发现工具 schema 的意外变更。 安装第三方 MCP 服务器前,检查其工具是否存在风险模式。 在 Pull Request 中将 MCP 检测结果上传到 GitHub Code Scanning。
mcp-observatory 怎么安装和运行?
使用 npx 运行首次扫描: npx -y @kryptosai/mcp-observatory@latest 测试指定的 MCP 服务器: npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything 打开本地仪表板查看结果: npx -y @kryptosai/mcp-observatory@latest dashboard
在哪里获取 mcp-observatory?
源代码和安装说明在 GitHub 上:https://github.com/KryptosAI/mcp-observatory

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目