Repolode
highflame-ai

highflame-ai/ramparts

用 Rust 编写的安全扫描器,检查 MCP 服务器和 AI 智能体 Skill 文件中的提示注入、工具投毒与密钥泄露等风险。

Star
98
Fork
20
未关闭 Issue
16
最近提交
14天前

这是什么?

Ramparts 扫描 AI 智能体最信任的两类对象:它所连接的 MCP 服务器,以及它按名称加载并执行的 Skill 文件,例如 Claude Code 自定义命令和 agentskills.io 格式的 Skill 目录。它支持 HTTP、SSE、stdio 和子进程等传输方式,可枚举服务器的工具、资源和提示词,并检查提示注入、工具投毒、路径穿越、命令注入和跨域提权等问题。

对于 Skill,它使用同一套分析流程处理 SKILL.md 目录及其附带的脚本。项目整合了 YARA 规则、基于 LLM 的语义分析、通过 OSV.dev 查询 npx/uvx 启动的 stdio 服务器和固定版本依赖的 CVE,并通过内容指纹检测审批后发生变化的 MCP 配置、工具或 Skill 文件。检测结果带有 OWASP MCP Top 10 与 Agentic Skills Top 10 标签,可输出为终端文本、JSON、SARIF 2.1.0 或 Markdown 报告。

项目可通过 cargo 安装,也可以用 `ramparts server` 启动 REST 服务,或以 stdio 方式作为 MCP 服务运行。项目仍在积极开发中,作者提示其检测并不完美,建议与运行时防护措施结合使用。

核心功能

  • 01支持通过 HTTP、SSE、stdio 和子进程方式扫描远程或本地 MCP 服务器。
  • 02扫描 Claude Code 命令和 agentskills.io Skill 包,包括附带的脚本和参考文档。
  • 03内置 40 条 YARA 规则,并对标准化及解码后的文本再次匹配,以识别混淆的关键词。
  • 04通过 OSV.dev 检查依赖中的已知 CVE。
  • 05检测审批后 MCP 配置、工具或 Skill 文件的变化。
  • 06结果可导出为终端输出、JSON、SARIF 2.1.0 或 Markdown 报告。

适用场景

  • 在将 AI 助手连接第三方 MCP 服务器之前进行安全审查。
  • 发布 agentskills.io Skill 包之前校验其规范与安全性。
  • 在 CI 中拦截新增 Skill 或修改 MCP 配置的 PR,并将结果输出为 SARIF。
  • 审计团队在 Claude Code、Cursor 等工具中安装的 Skill。

快速上手

  1. 1

    使用 Cargo 安装 Ramparts

    cargo install ramparts
  2. 2

    扫描 stdio 类型的 MCP 服务器

    ramparts scan "stdio:npx:mcp-server-commands"
  3. 3

    自动发现并扫描 IDE 配置中的 MCP 服务器

    ramparts scan-config

使用前须知

  • Ramparts 仍在积极开发中,并不完美,部分检测结果可能不准确。
  • 它分析的是静态元数据、配置和技能文件,不能替代运行时防护。
  • 基于 LLM 的分析需要额外配置,快速开始部分未涉及。

标签

常见问题

ramparts 是什么?
用 Rust 编写的安全扫描器,检查 MCP 服务器和 AI 智能体 Skill 文件中的提示注入、工具投毒与密钥泄露等风险。 Ramparts 扫描 AI 智能体最信任的两类对象:它所连接的 MCP 服务器,以及它按名称加载并执行的 Skill 文件,例如 Claude Code 自定义命令和 agentskills.io 格式的 Skill 目录。它支持 HTTP、SSE、stdio 和子进程等传输方式,可枚举服务器的工具、资源和提示词,并检查提示注入、工具投毒、路径穿越、命令注入和跨域提权等问题。
ramparts 可以免费使用吗?用的什么许可证?
ramparts 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
ramparts 还在维护吗?
活跃维护中。ramparts 最近一次提交是在 2026年10月8日。
ramparts 适合用来做什么?
在将 AI 助手连接第三方 MCP 服务器之前进行安全审查。 发布 agentskills.io Skill 包之前校验其规范与安全性。 在 CI 中拦截新增 Skill 或修改 MCP 配置的 PR,并将结果输出为 SARIF。 审计团队在 Claude Code、Cursor 等工具中安装的 Skill。
ramparts 怎么安装和运行?
使用 Cargo 安装 Ramparts: cargo install ramparts 扫描 stdio 类型的 MCP 服务器: ramparts scan "stdio:npx:mcp-server-commands" 自动发现并扫描 IDE 配置中的 MCP 服务器: ramparts scan-config
在哪里获取 ramparts?
源代码和安装说明在 GitHub 上:https://github.com/highflame-ai/ramparts

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

相关项目