Repolode
Pantheon-Security

Pantheon-Security/medusa

面向代码与 AI 智能体配置的安全扫描器,内置 LLM 应用、MCP 服务与泄露密钥等检测规则。

Star
1,015
Fork
155
未关闭 Issue
3
最近提交
3个月前

这是什么?

MEDUSA 是一款用 Python 编写的命令行安全扫描器,内置大量规则,覆盖 AI/ML 应用、LLM 智能体、MCP 服务、RAG 流水线以及常规代码,无需额外安装外部工具。若系统中已安装 bandit、eslint 等外部 linter,扫描时会自动调用。

除通用 SAST 扫描外,它还针对 AI 场景的风险。`medusa scan --git` 可在克隆前检查远程仓库,包括 `.cursorrules`、`.claude/` 中的 hooks 与权限配置,以及 MCP 配置中是否存在投毒或权限过大的内容。`medusa secrets scan` 会在 AI 助手聊天记录和 shell 历史中查找 API 密钥与令牌,`purge` 子命令则以交互方式脱敏,并在修改前生成逐字节一致的备份。

扫描结果可导出为 JSON、HTML、Markdown、SARIF、JUnit 或纯文本格式。工具支持基于内容哈希的增量扫描缓存、通过 `.medusa.yml` 进行配置,并可通过生成的上下文文件与 Claude Code、Gemini CLI、Cursor、Copilot、OpenAI Codex 集成。

核心功能

  • 01克隆前用 `medusa scan --git` 扫描任意 GitHub 仓库,包括 AI 编辑器配置文件。
  • 02在 AI 聊天记录与 shell 历史中查找 API 密钥和令牌,支持交互式脱敏并自动备份。
  • 03内置提示注入、MCP 工具投毒、RAG 与智能体安全相关规则。
  • 04提供 Rust 与 PHP 原生规则,并可自动调用已安装的外部 linter。
  • 05结果可导出为 JSON、HTML、Markdown、SARIF、JUnit 或文本,并通过 `--fail-on` 用于 CI。

适用场景

  • 在克隆或运行第三方仓库、Claude Code 配置之前进行安全检查。
  • 排查 shell 历史或 AI 助手日志中是否残留凭据。
  • 在 CI 流水线中以 SARIF 或 JUnit 输出作为安全门禁。
  • 审计 LLM 应用与 MCP 服务中的提示注入和工具投毒风险。

快速上手

  1. 1

    从 PyPI 安装 MEDUSA

    pip install medusa-security
  2. 2

    对当前文件夹运行第一次扫描

    medusa scan .

使用前须知

  • 采用 AGPL-3.0 许可证,这是一种 copyleft 许可证,修改后用于网络服务时可能需要开放源代码。
  • 部分可选的外部检查工具需要另行按各供应商文档安装。

收录于专题

标签

常见问题

medusa 是什么?
面向代码与 AI 智能体配置的安全扫描器,内置 LLM 应用、MCP 服务与泄露密钥等检测规则。 MEDUSA 是一款用 Python 编写的命令行安全扫描器,内置大量规则,覆盖 AI/ML 应用、LLM 智能体、MCP 服务、RAG 流水线以及常规代码,无需额外安装外部工具。若系统中已安装 bandit、eslint 等外部 linter,扫描时会自动调用。
medusa 可以免费使用吗?用的什么许可证?
medusa 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
medusa 还在维护吗?
半年内有更新。medusa 最近一次提交是在 2026年8月10日。
medusa 适合用来做什么?
在克隆或运行第三方仓库、Claude Code 配置之前进行安全检查。 排查 shell 历史或 AI 助手日志中是否残留凭据。 在 CI 流水线中以 SARIF 或 JUnit 输出作为安全门禁。 审计 LLM 应用与 MCP 服务中的提示注入和工具投毒风险。
medusa 怎么安装和运行?
从 PyPI 安装 MEDUSA: pip install medusa-security 对当前文件夹运行第一次扫描: medusa scan .
在哪里获取 medusa?
源代码和安装说明在 GitHub 上:https://github.com/Pantheon-Security/medusa

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

相关项目