EU Audit Trail

eu-audit-mcp

用于遵循《欧盟 AI 法案》和 GDPR 的防篡改审计跟踪 MCP 服务。专为通过 stdio 传输集成到本地桌面应用而设计。

功能

• 防篡改日志记录 — 对所有事件使用 HMAC-SHA256 哈希链
• PII 扫描 — 通过 Microsoft Presidio 自动检测并编辑 PII（欧盟模式）
• GDPR 删除权 — 支持第 17 条删除权，并保留审计跟踪
• 合规性检查 — 对照《欧盟 AI 法案》第 12/19 条和 GDPR 第 30 条进行技术清单检查
• 本地优先 — 所有数据都保留在你的设备上，存储于单个 SQLite 文件中

监管背景

此服务为以下欧盟法规实施技术措施：

法规	条款	要求
《欧盟 AI 法案》（2024/1689）	第 12 条	对高风险 AI 系统的事件（日志）进行自动记录
	第 19 条	自动生成的日志至少保留 6 个月
GDPR（2016/679）	第 17 条	个人数据删除权（“被遗忘权”）
	第 30 条	处理活动记录，包括处理目的和数据类别

《欧盟 AI 法案》针对高风险系统的义务将于 2026 年 8 月 2 日 生效。

请参阅 LEGAL_REFERENCES.md，了解完整条文以及每项工具如何满足各项要求的详细对应关系。

免责声明： 此工具提供的是技术清单，而非法律建议。请咨询合格的法律顾问，以做出合规决策。

快速开始

pip install -e ".[dev]"

运行服务（stdio）

python -m eu_audit_mcp.server

MCP 客户端配置

{
  "mcpServers": {
    "eu-audit": {
      "command": "python",
      "args": ["-m", "eu_audit_mcp.server"],
      "env": {
        "AUDIT_CONFIG": "./audit_config.yaml"
      }
    }
  }
}

运行测试

pytest tests/

MCP 工具

工具	描述
log_event	记录审计事件并自动扫描 PII
log_inference	记录大模型推理调用（模型、令牌、费用）
log_data_access	记录文档/数据访问事件
query_log	按时间范围、类型和会话搜索事件
get_session_trace	获取会话的完整有序跟踪记录
get_stats	获取一段时间内的汇总统计数据
compliance_check	对照《欧盟 AI 法案》第 12/19 条和 GDPR 第 30 条进行检查
execute_erasure	执行 GDPR 第 17 条删除权
get_pii_summary	汇总已检测到的 PII 类型（仅计数）
verify_chain	验证哈希链完整性

配置

复制示例配置并进行自定义：

cp audit_config.example.yaml audit_config.yaml

将 AUDIT_CONFIG 环境变量设为指向你的配置文件。如果其中包含 chain_secret，请勿提交 audit_config.yaml——默认情况下，它已列在 .gitignore 中。

安全性

请参阅 SECURITY.md，了解威胁模型、安全措施和漏洞报告方式。

许可证

Apache-2.0