mcp-eu-ai-act

欧盟 AI 法案合规扫描器 — CLI + MCP 服务

一条命令，无需配置。不到 10 秒即可获得完整的欧盟 AI 法案 + GDPR 合规报告。

pip install eu-ai-act-scanner
eu-ai-act-scanner /path/to/your/project

可检测代码库中的 16 种 AI 框架，将每种框架对应到有约束力的法律条款，并提供通过/未通过结果及修复说明。提供免费版，无需 API 密钥。

执法期限为 2026 年 8 月 2 日。罚款最高可达 3,500 万欧元或全球营业额的 7%。

如果此工具对您的合规工作有所帮助，请在 GitHub 上点个 ⭐，帮助更多人发现它。

需要可用于审计的证明？ 使用 ArkForge Trust Layer 为每次扫描生成认证——防篡改、带时间戳的合规证据。每月免费提供 500 份证明。

获取合规报告 →

快速开始

CLI（10 秒扫描任意项目）

pip install eu-ai-act-scanner   # or: pip install mcp-eu-ai-act
cd your-project/
eu-ai-act-scanner

输出：

========================================================================
  EU AI Act Compliance Scanner
========================================================================

  Files scanned: 42
  AI frameworks detected: 2
    - openai (in 3 files)
    - langchain (in 1 file)

  Risk category: limited
  Compliance score: 4/7 (57%)
  Checks:
    [PASS] Transparency
    [PASS] User Disclosure
    [FAIL] Technical Documentation  → Create docs/TECHNICAL_DOCUMENTATION.md
    [FAIL] Risk Management          → Create docs/RISK_MANAGEMENT.md
    [FAIL] Data Governance          → Create docs/DATA_GOVERNANCE.md

也可以直接指定路径：eu-ai-act-scanner /path/to/your/project

免费跟踪合规情况：eu-ai-act-scanner . --register [email protected]

免费版与 Pro 版

	免费版	Pro（€29/月）	Certified（€99/月）
每日扫描次数	5	不限	不限
AI 框架检测	✓（16 种框架）	✓（16 种框架）	✓（16 种框架）
风险类别建议	✓	✓	✓
合规检查	—	✓（内容评分 0-100）	✓
完整合规报告	—	✓（执行摘要 + 技术报告）	✓
合规路线图	—	✓（逐周计划）	✓
Annex IV 套件	—	✓（可供审计的 ZIP）	✓
GDPR 扫描	—	✓	✓
欧盟 AI 法案 + GDPR 综合检查	—	✓（双重合规热点）	✓
Trust Layer 认证	—	—	✓（加密证明）
CI/CD 集成	—	✓	✓
API 密钥	无需	✓	✓
可用工具数	2	10	10 + 认证

免费版：无需注册，无需 API 密钥——只需 pip install 并扫描即可。Pro 版提供团队在 2027 年 8 月期限前所需的完整合规工具包。

→ 比较套餐并获取 API 密钥

v2 新功能

功能	描述
generate_compliance_roadmap	逐周行动计划，助您在期限前实现合规
generate_annex4_package	可供审计的 ZIP，包含根据代码填写的全部 8 个 Annex IV 章节
certify_compliance_report	通过 Trust Layer 提供加密证明（欧盟 AI 法案第 12 条）
内容评分	check_compliance 现在会对文档内容评分（0-100），而不仅仅是检查是否存在
条款映射	每项发现都会映射到具体的欧盟 AI 法案条款

MCP 服务（从源代码运行）

git clone https://github.com/ark-forge/mcp-eu-ai-act.git
cd mcp-eu-ai-act
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

运行测试

pip install pytest
pytest tests/ -v

MCP 集成

从 PyPI 安装（推荐）

pip install eu-ai-act-scanner

Claude Code

claude mcp add eu-ai-act -- eu-ai-act-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "eu-ai-act": {
      "command": "eu-ai-act-mcp"
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "eu-ai-act": {
      "command": "eu-ai-act-mcp"
    }
  }
}

HTTP 模式（适用于 CI/CD 或远程客户端）

pip install uvicorn
python3 server.py --http
# Listening on 0.0.0.0:8089

工具参考

1. scan_project

检测源代码和配置/清单文件中是否使用了 AI 框架。支持 Python、JS、TS、Go、Java 和 Rust 中的 16 种框架。

关键参数： project_path（字符串，必填）

输出示例：

{
  "files_scanned": 42,
  "ai_files": [
    {"file": "src/chat.py", "frameworks": ["openai"]},
    {"file": "requirements.txt", "frameworks": ["openai"], "source": "config"}
  ],
  "detected_models": {"openai": ["src/chat.py", "requirements.txt"]}
}

---

2. check_compliance

评估文档内容质量（0–100 分），并将每项发现映射到具体的《欧盟 AI 法案》条款。得分 ≥40 即通过。完全向后兼容 v1。

关键参数： project_path（字符串，必填）、risk_category（字符串，默认值：limited）

输出示例（v2）：

{
  "risk_category": "high",
  "compliance_score": "4/6",
  "compliance_percentage": 66.7,
  "content_scores": {
    "RISK_MANAGEMENT.md": 82,
    "TRANSPARENCY.md": 45,
    "DATA_GOVERNANCE.md": 12
  },
  "article_map": {
    "art_9": {"status": "pass", "score": 82},
    "art_10": {"status": "fail", "score": 12},
    "art_13": {"status": "pass", "score": 45}
  }
}

---

3. generate_compliance_roadmap — v2 新增

制定按截止日期安排的逐周行动计划，助您在 2026 年 8 月 2 日前达到《欧盟 AI 法案》合规要求。通过关键性 × 1/工作量算法，优先安排易于快速完成的事项。

关键参数： project_path（字符串，必填）、risk_category（字符串）、target_date（字符串，ISO 格式，默认值：2027-08-02）

输出示例：

{
  "weeks_remaining": 16,
  "phases": [
    {
      "week": 1,
      "action": "Add TRANSPARENCY.md with user disclosure statement",
      "article": "Art. 13",
      "effort_days": 1,
      "priority": "critical"
    },
    {
      "week": 2,
      "action": "Draft risk management procedure covering Art. 9 requirements",
      "article": "Art. 9",
      "effort_days": 3,
      "priority": "high"
    }
  ],
  "estimated_completion_week": 8
}

---

4. generate_report

运行扫描和合规检查，返回一份综合报告，采用两级输出：面向 DPO/法律人员的执行摘要，以及面向开发人员的技术分析。报告包含逐条条款引用。

关键参数： project_path（字符串，必填）、risk_category（字符串，默认值：limited）

输出示例：

{
  "executive_summary": {
    "compliance_percentage": 67,
    "deadline": "2027-08-02",
    "days_remaining": 117,
    "gap_count": 3,
    "verdict": "Action required — 3 gaps must be addressed before deadline"
  },
  "technical_breakdown": {
    "art_9": {"status": "fail", "missing": ["hazard identification section", "residual risk log"]},
    "art_13": {"status": "pass", "score": 78}
  },
  "recommendations": [
    {"article": "Art. 9", "action": "Add hazard identification section to RISK_MANAGEMENT.md", "effort": "2 days"}
  ]
}

---

5. suggest_risk_category

根据纯文本描述，将您的 AI 系统归类到《欧盟 AI 法案》的某个风险类别。对照第 5 条（禁止事项）、附件 III（高风险）、第 52 条（有限风险）和最低风险进行分类。

关键参数： system_description（字符串，必填）

输出示例：

{
  "suggested_category": "high",
  "confidence": "high",
  "matched_criteria": ["Annex III, Category 4 — AI in employment decisions"],
  "obligations_summary": "Technical documentation, risk management, human oversight, data governance, transparency"
}

---

6. generate_compliance_templates

返回每份必需合规文件的 Markdown 入门模板。将其保存到 docs/，并填写方括号中的部分。

关键参数： risk_category（字符串，默认值：high）

对于 high 风险：风险管理（第 9 条）、技术文档（第 11 条）、数据治理（第 10 条）、人工监督（第 14 条）、稳健性（第 15 条）、透明度（第 13 条）。

---

7. generate_annex4_package — v2 新增

生成可供审计人员使用的 ZIP 文件，其中包含根据您的实际项目文件填写的附件 IV 全部 8 个部分。可选通过 Trust Layer 进行认证，提供加密证明。

关键参数： project_path（字符串，必填）、sign_with_trust_layer（布尔值，默认值：false）、trust_layer_key（字符串，可选）

输出示例：

{
  "package_path": "/tmp/annex4_myproject_20260407.zip",
  "sha256": "a3f8c2d1...",
  "sections_populated": 8,
  "sections_missing_data": ["section_6_accuracy_metrics"],
  "proof_id": "prf_01j9z8x7w6v5u4t3s2r1",
  "verification_url": "https://trust.arkforge.tech/verify/prf_01j9z8x7w6v5u4t3s2r1"
}

---

8. certify_compliance_report — v2 新增

通过 ArkForge Trust Layer 为任何合规报告进行认证。返回防篡改的 proof_id 和公开验证 URL，供审计人员使用（《欧盟 AI 法案》第 12 条审计跟踪记录）。

关键参数： report_data（字符串，JSON 序列化报告）、trust_layer_key（字符串，必填）

输出示例：

{
  "proof_id": "prf_01j9z8x7w6v5u4t3s2r1",
  "timestamp": "2026-04-07T14:32:00Z",
  "sha256": "a3f8c2d1e4b5...",
  "verification_url": "https://trust.arkforge.tech/verify/prf_01j9z8x7w6v5u4t3s2r1",
  "article": "EU AI Act Art. 12"
}

---

9. gdpr_scan_project

扫描个人数据处理模式：PII 字段、跟踪像素、地理位置、文件上传和 Cookie 模式。映射到 GDPR 第 22/35 条要求。

关键参数： project_path（字符串，必填）

---

10. combined_compliance_report

同时运行 GDPR 和《欧盟 AI 法案》扫描，并识别双重合规热点——即同时受两项法规约束的文件。

关键参数： project_path（字符串，必填）、risk_category（字符串，默认值：limited）

输出示例：

{
  "hotspots": [
    {
      "file": "src/hiring_model.py",
      "eu_ai_act_risk": "high",
      "gdpr_risk": "high",
      "overlap_patterns": ["AI+PII", "AI+automated_decision"],
      "combined_articles": ["EU AI Act Art. 14", "GDPR Art. 22"],
      "priority": "critical"
    }
  ],
  "key_insight": "2 files require simultaneous GDPR + EU AI Act remediation"
}

---

认证您的合规性（《欧盟 AI 法案》第 12 条）

唯一能够生成经加密认证的合规证据的 MCP。

# Step 1: Generate Annex IV package and certify it
generate_annex4_package(
    project_path="/path/to/project",
    sign_with_trust_layer=True,
    trust_layer_key="your_trust_layer_key"
)
# → Returns proof_id + public verification URL for your auditor

# Step 2: Or certify any compliance report directly
certify_compliance_report(
    report_data='{"compliance_percentage": 87, "risk_category": "high"}',
    trust_layer_key="your_trust_layer_key"
)

免费 Trust Layer 账户：每月 500 份经认证的证明 → arkforge.tech

定价

套餐	价格	包含内容
免费版	€0	每天 5 次扫描 · scan_project + suggest_risk_category
Pro	€29/月	无限次扫描 · 全部 10 个工具 · 合规路线图 · Annex IV 套件
Certified	€99/月	包含 Pro 的全部内容 + 每份报告均提供 Trust Layer 认证

获取 API 密钥 →

REST API

独立的 HTTP API（paywall_api.py）为 CI/CD 和外部客户端提供带速率限制的 REST 端点。

python3 paywall_api.py
# Listening on 0.0.0.0:8091

方法	路径	身份验证	描述
GET	/api/v1/status	无	服务状态 + 你的速率限制
GET	/api/usage	无	你当前 IP 的免费套餐用量
POST	/api/v1/scan	免费/Pro	扫描项目，检测 AI 框架
POST	/api/v1/check-compliance	免费/Pro	检查是否符合 EU AI Act
POST	/api/v1/generate-report	免费/Pro	完整的合规报告
POST	/api/v1/scan-repo	免费（受速率限制）	按 URL 扫描公开的 HTTPS Git 仓库（端口 443，仅限公开主机）
POST	/api/checkout	无	Stripe 结账会话
POST	/api/webhook	Stripe 签名	Stripe Webhook 处理程序

免费套餐：每个 IP 每天 5 次扫描，无需注册。 Pro 套餐：无限次扫描，使用 X-API-Key 标头。通过 arkforge.tech/pricing 订阅，每月 29 EUR。

示例：通过 REST 扫描

curl -X POST https://arkforge.tech/mcp/api/v1/scan \
  -H "Content-Type: application/json" \
  -d '{"project_path": "/path/to/your/project"}'

配置

对于 REST API（Stripe 付款、电子邮件通知），请创建 settings.env：

STRIPE_LIVE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
TRUST_LAYER_INTERNAL_SECRET=<random-64-char-hex>
SMTP_HOST=ssl0.ovh.net
[email protected]
IMAP_PASSWORD=...

将 SETTINGS_ENV_PATH 设置为文件位置（默认为 /opt/claude-ceo/config/settings.env）。

支持的框架（16 种）

框架	检测范围
OpenAI	GPT-3.5、GPT-4、GPT-4o、o1、o3、嵌入
Anthropic	Claude（Opus、Sonnet、Haiku）
Google Gemini	Gemini Pro、Ultra、1.5、2、3、Flash
Vertex AI	Google Cloud AI Platform
Mistral	Mistral Large/Medium/Small、Mixtral、Codestral、Magistral
Cohere	Command-R、Command-R+、嵌入
HuggingFace	Transformers、Diffusers、Accelerate、SmolAgents
TensorFlow	Keras、.h5 模型文件
PyTorch	.pt/.pth 模型文件、nn.Module
LangChain	Core、Community、OpenAI、Anthropic 集成
AWS Bedrock	Bedrock Runtime、Agent Runtime
Azure OpenAI	Azure AI OpenAI Service
Ollama	本地模型推理
LlamaIndex	VectorStoreIndex、SimpleDirectoryReader
Replicate	云端模型推理
Groq	快速推理 API

可通过源代码导入语句和配置文件中的依赖声明进行检测。

EU AI Act 风险类别

类别	示例	主要义务
不可接受	社会评分、大规模生物特征监控	禁止
高风险	招聘、信用评分、执法	文档记录、风险管理、人类监督
有限风险	聊天机器人、内容生成	透明度、用户告知、内容标记
最低风险	垃圾邮件过滤器、电子游戏	无

限制

• 仅进行静态分析——检测导入语句和模式，不检测运行时行为
• 仅凭代码无法自动确定风险类别（请使用 suggest_risk_category 并提供描述）
• check_compliance 会对内容质量进行评分——包含套话/占位文本的文档得分会较低
• 文件扫描上限为 5,000 个文件，每个文件 1 MB
• 出于安全考虑，某些系统路径会被禁止扫描

ArkForge 生态系统

此扫描器是首个通过 ArkForge Trust Layer 自主销售的服务。ArkForge Trust Layer 是一个认证代理，可将 API 调用转化为可验证、付费且防篡改的交易。

Agent Client  →  Trust Layer  →  EU AI Act Scanner
   pays            certifies         delivers

组件	描述	仓库
Trust Layer	认证代理 — 计费、证明链、验证	ark-forge/trust-layer
MCP EU AI Act	合规工具包（本仓库）	ark-forge/mcp-eu-ai-act
Proof Spec	证明格式的开放规范和测试向量	ark-forge/proof-spec
Agent Client	自主买家 — 非人类客户的概念验证	ark-forge/arkforge-agent-client

社区

• 问题 / 集成帮助 → GitHub Discussions 问答
• 错误报告 → 提交 issue
• 功能请求 → 提交 issue 或参与讨论
• 分享你的体验 → 告诉我们你发现了哪些合规漏洞

路线图

• v3：GPAI 义务模块（第 51-55 条，《行为准则》，2025 年 7 月）
• v3：用于 CI/CD 合规门禁的 GitHub Action
• v3：运行时 Agentic 合规执行（第 14 条）

---

觉得有用吗？ 在 GitHub 上点一个 ⭐，可以帮助其他合规团队发现此工具包。只需 2 秒，却能带来很大帮助。

许可证

MIT