AIR Blackbox MCP Server 是 AIR Blackbox 生态中的 MCP 服务器组件,用于对 Python AI 智能体进行欧盟 AI 法案合规扫描,并暴露审计、回放、扫描和合规工具给任何兼容 MCP 的智能体或 IDE。
用途
该项目面向使用 Claude Desktop、Claude Code、Cursor 等 MCP 兼容客户端的开发者,帮助其对 AI 智能体代码进行欧盟 AI 法案合规检查、提示注入检测、风险分类、修复生成、GDPR 合规检查、偏见分析和合规报告。它支持的框架包括 LangChain、CrewAI、AutoGen、OpenAI、Haystack、LlamaIndex、Semantic Kernel、Google ADK、Claude Agent SDK,以及通用 RAG 流水线。
主要能力
工具分为两个层级:
- 基础版(10 个工具,无 SDK 功能):仅使用内置轻量扫描器即可独立运行,覆盖 6 条欧盟 AI 法案条款的扫描,并检测提示注入(15 种模式)。
- 完整版(14 个工具,含 GDPR、偏见、验证和历史):需安装 air-blackbox SDK(>=1.13,<2)以解锁高级合规功能。
完整版 SDK 解锁的 4 个额外工具:
- GDPR 扫描(scan_gdpr):检测未经同意的个人数据处理、数据保留与擦除策略、跨境传输保障、数据处理协议。
- 偏见分析(scan_bias):检测差别影响风险、受保护属性处理、训练数据偏见指标、公平性指标意识。
- 动作验证(validate_action):执行前审批门(第 14 条)、ConsentGate 策略执行、基于风险的动过滤、审计追踪生成。
- 合规历史(compliance_history):追踪历史扫描结果、分析合规趋势、导出审计追踪、监控随时间改进情况。
产品定位强调不仅扫描还修复:发现 6 条欧盟 AI 法案条款问题并生成可用的代码修复;结合正则模式、AI 驱动模型分析和提示注入检测;通过预审批门和风险分类在执行前验证智能体动作(第 14 条);通过 SDK 提供 GDPR 检查、偏见分析、完整报告和历史趋势监控。
使用方式
安装后按客户端配置:
- Claude Desktop:编辑 ~/Library/Application Support/Claude/claude_desktop_config.json,重启 Claude Desktop 后 14 个工具自动出现。
- Claude Code / Cursor:在项目的 .cursor/mcp.json 中添加配置,或在 Claude Code 的 .claude/mcp.json 中添加。
配置完成后,可直接用自然语言调用,例如: “Scan this code for EU AI Act compliance” “Add a trust layer to this LangChain agent” “Check this text for prompt injection” “What does Article 12 require?” “Generate a compliance report for ~/myproject” “Classify the risk level of send_email” “Scan this code for GDPR issues”(需要完整 SDK) “Check for bias in this AI model code”(需要完整 SDK) “Can my agent call this shell function?”(需要完整 SDK) “Show me my compliance trends”(需要完整 SDK)
可选:如需超越正则模式的 AI 分析,可配合 Ollama 进行深度分析。安装 [full] 可解锁 Tier 5 SDK 工具;基础安装可独立工作。
MCP SDK 兼容性方面,该包支持两代 MCP SDK(mcp>=1.0,无上限)。mcp 2.0 移除了 mcp.server.fastmcp 并将 FastMCP 替换为 MCPServer,该服务器会检测已安装的代际并绑定到正确的类,因此在 1.x 和 2.x 上均可运行。0.2.3 版本曾声明未固定上限的 mcp>=1.0.0,导致 mcp 2.0 发布后新安装的服务器导入即崩溃;0.2.4 通过限制 mcp<2 修复,0.3.0 完全移除了上限。
结果溯源
每个机器可读结果都带有溯源块:engine(builtin-rules 或 air-blackbox-sdk,实际运行者)、ruleset_version(活动规则的内容哈希,而非手工维护字符串)、sdk_version(产生该结果的 SDK 版本,内置结果时为 null)。具有相同 engine + ruleset_version 的两份报告由字节级相同规则生成,可直接比较;不同值意味着规则已变化。错误信息也带有溯源。
适用场景
适用于需要对 Python AI 智能体进行欧盟 AI 法案合规扫描、提示注入检测、风险分类、修复生成、GDPR 检查、偏见分析,并希望接入 Claude Desktop、Claude Code、Cursor 等 MCP 客户端的开发与合规场景。
限制
基础版不具备 GDPR、偏见、验证和历史功能,这些需要安装完整 air-blackbox SDK。其余如价格、收费模式、平台支持范围等具体信息,资料中暂未提供。