Bawbel Scanner

Bawbel MCP Server

面向 MCP 服务和 Agentic AI 组件的安全扫描器，以 MCP 工具的形式提供。

Bawbel MCP Server 让任何兼容 MCP 的 Agent 都能在对话过程中扫描服务、检查技能文件、 评估规范符合度、管理有依据的抑制项，并查询 AVE 威胁情报数据库。

---

安装

pip install bawbel-mcp

或安装所有检测引擎（YARA、Semgrep、LLM、Magika、Sandbox）：

pip install "bawbel-mcp[all]"

---

工具

工具	描述
scan_content	扫描原始文本内容，检查 AVE 漏洞
scan_server_card	连接前获取并扫描 MCP 服务卡片
scan_creds	针对凭据的扫描（API 密钥、令牌、密码、私钥）
scan_chain	委派链扫描（不安全的子 Agent 生成和继承的权限）
check_conformance	根据 MCP 规范评估服务清单（18 项检查，A+ 到 F）
accept_finding	插入有依据的抑制项，并注明原因、审核者和可选的到期时间
lookup_ave	按 ID 获取完整的 AVE 记录及修复指导
search_ave	按关键词搜索 AVE 记录
list_ave	列出所有 AVE 记录，可按严重性／类别筛选
check_pins	检测技能文件目录中的 rug pull 漂移

资源

资源	描述
ave://stats	当前 AVE 数据库统计信息
ave://record/{ave_id}	指定 ID 的完整 AVE 记录

---

使用方法

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "bawbel": {
      "command": "uvx",
      "args": ["bawbel-mcp"]
    }
  }
}

Claude Code

claude mcp add bawbel uvx bawbel-mcp

Cursor / Windsurf

添加到 MCP 设置中：

{
  "bawbel": {
    "command": "uvx",
    "args": ["bawbel-mcp"]
  }
}

远程部署（Streamable HTTP）

uvx bawbel-mcp --transport streamable-http --host 0.0.0.0 --port 8000

---

示例对话

连接前扫描服务器：

"在将这个 MCP 服务添加到配置之前，先扫描一下安全问题： https://api.some-mcp-server.com"

Claude 调用 scan_server_card("https://api.some-mcp-server.com")，并报告 发现的问题，包括 AVE ID、AIVSS 严重性评分和修复步骤。

检查技能文件：

"检查此技能文件内容是否存在提示词注入漏洞"

Claude 调用 scan_content(content)，并返回发现的问题，包括检测到的 任何有毒流程链。

检查硬编码凭据：

"此技能文件是否包含任何硬编码的 API 密钥或机密信息？"

Claude 调用 scan_creds(content)，并仅返回凭据相关发现。

检查不安全的委派：

"此技能是否会在没有适当信任边界的情况下生成子 Agent？"

Claude 调用 scan_chain(content)，并返回委派链相关发现。

接受误报：

"将 travel.md 第 7 行的 AVE-2026-00001 标记为误报。 原因：内部注册表端点，不受攻击者控制。"

Claude 调用 accept_finding(...)，并将说明充分的抑制注释直接写入 文件。审批记录会纳入版本控制。

根据规范评估服务器：

"此服务器是否遵循 MCP 规范？https://api.some-mcp-server.com"

Claude 调用 check_conformance("https://api.some-mcp-server.com")，并 返回评分、等级和未通过检查的列表。

查询漏洞：

"AVE-2026-00041 是什么？如何修复？"

Claude 调用 lookup_ave("AVE-2026-00041")，并返回完整记录， 包括行为特征、IOC 和修复步骤。

搜索相关漏洞：

"哪些 AVE 记录涉及凭据窃取？"

Claude 调用 search_ave("credential exfiltration")，并返回匹配的 记录，包括 AIVSS 评分和 OWASP MCP 类别。

审计模式——查看所有发现，包括已抑制的发现：

"扫描此文件并显示所有内容，包括已抑制的发现。"

Claude 调用 scan_content(content, no_ignore=True)，并绕过所有 抑制层。

---

要求

• Python 3.10+
• bawbel-scanner>=1.2.2（自动安装）
• fastmcp>=3.0.0（自动安装）

bawbel CLI 必须位于 PATH 中。安装 bawbel-mcp 会安装提供 bawbel CLI 的 bawbel-scanner。

---

相关项目

• bawbel-scanner - CLI 扫描器
• bawbel/ave - AVE 标准和记录
• api.piranha.bawbel.io - 威胁情报 API
• bawbel.io/docs - 完整文档

---

Apache 2.0。由 Bawbel 构建。