ActTrace

本地服务

github.com法律与政务124 周前更新

代码仓库访问官网

关于 ActTrace

ActTrace 是面向非金融 SaaS 和科技团队的 EU AI Act 合规 API，可确定性地分类风险并起草 Article 50 透明度通知，也提供免费诊断；它不提供法律意见或合规认证。

主要功能

01依据 EU AI Act 分类 AI 功能
02生成 Article 50 透明度通知
03运行免费风险诊断
04将金融服务案例标记为范围外

适用场景

01评估 AI 功能的监管风险
02为 AI 系统起草透明度通知
03在律师审核前筛查产品功能

MCP 相关

该 MCP 服务向 MCP 客户端提供 `acttrace_classify` 和 `acttrace_generate_transparency_notice` 工具。两者均使用 API 的 `X-API-Key` 进行身份验证。

#eu-ai-act #ai-act #compliance #ai-governance #article-50 #transparency #risk-classification

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令uvx acttrace-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiacttrace-mcp0.1.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

ActTrace

面向开发者的欧盟《人工智能法案》合规 API，适用于非金融 SaaS 和科技公司。ActTrace 为工程团队提供三项功能，可通过 API 或 MCP 自助使用：

对 AI 功能进行确定性的风险分类，依据欧盟《人工智能法案》。
可直接发布的第 50 条透明度告知文本。
免费诊断，作为公开入口。

非法律建议。 ActTrace 提供运营合规工作流支持和文档草稿。它不提供法律建议、不认证合规性，也不能替代合格法律顾问的审查。每条响应都附带此免责声明。

ActTrace 面向非金融公司。金融服务用例（银行、交易、投资组合／投资建议、信用评分，……）会被明确归类为 out_of_scope_financial_services。

安装 — Claude Code 插件 / MCP 服务

ActTrace 以 Claude Code 插件形式提供：包含一个 acttrace 技能和一个本地 MCP 服务。MCP 服务通过 uvx 运行——这是一个确定性规则引擎，可离线使用，无需 API 密钥。

/plugin marketplace add goww7/acttrace
/plugin install acttrace@acttrace

然后向 Claude 提问 “我的聊天机器人符合欧盟《人工智能法案》吗？” 或 “为我们的支持助手编写一份第 50 条告知文本。” MCP 服务也可通过 uvx acttrace-mcp 独立运行，兼容任何 MCP 客户端。

快速入门

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn acttrace.app:app --reload --port 8080

# 1. Free diagnostic — no key needed
curl -s localhost:8080/api/acttrace/diagnostics/free -H 'content-type: application/json' -d '{
  "feature_name": "AI reply assistant",
  "description": "Drafts suggested customer support replies for agents.",
  "user_facing": true, "model_provider": "OpenAI", "use_case": "support_assist"
}'

# 2. Mint an API key
KEY=$(curl -s -XPOST localhost:8080/api/keys/generate | python3 -c 'import sys,json;print(json.load(sys.stdin)["api_key"])')

# 3. Classify (15 tokens)
curl -s localhost:8080/api/acttrace/classify -H "X-API-Key: $KEY" -H 'content-type: application/json' -d '{
  "feature_name": "AI reply assistant",
  "description": "Drafts customer support replies shown to agents.",
  "use_case": "support_assist", "user_facing": true, "model_provider": "OpenAI"
}'

# 4. Generate an Article 50 notice (10 tokens)
curl -s localhost:8080/api/acttrace/notices -H "X-API-Key: $KEY" -H 'content-type: application/json' -d '{
  "ai_system_name": "Support Copilot", "notice_type": "chatbot", "tone": "plain"
}'

端点

方法与路径	身份验证	令牌	用途
`POST /api/acttrace/diagnostics/free`	无	0	公开风险诊断
`POST /api/acttrace/classify`	密钥	15	记录在案的风险分类
`POST /api/acttrace/notices`	密钥	10	第 50 条透明度告知文本
`POST /api/keys/generate`	无	0	签发免费套餐密钥
`GET /api/health`	无	0	存活状态

身份验证使用 X-API-Key。响应包含 X-Request-ID、X-Plan、X-Tokens-Charged、X-Tokens-Remaining、X-RateLimit-*。错误采用结构化格式 {"code","message","detail"}（401/403/429）。

MCP

python -m acttrace.mcp_server --sse --port 8002 会公开两个工具——acttrace_classify 和 acttrace_generate_transparency_notice——并使用相同的 X-API-Key 进行身份验证。Claude Code 技能位于 skill/acttrace/。

测试

.venv/bin/python -m pytest -q

共 54 项测试：分类引擎（7 个验收样例）、冲突防护、告知文本生成器和 HTTP API 契约。

部署

docker-compose.yml 会在 8080 / 8002 端口上构建由两个容器（API + MCP）组成的独立部署栈，并使用独立的数据卷——与 FinanceData2 隔离。要正式上线，请将 caddy-acttrace.snippet 附加到共享的 Caddyfile（替换占位域名）。完整的构建规范请参阅 BLUEPRINT.md。

目录结构

acttrace/
  app.py config.py dependencies.py
  middleware/   api_key_auth.py
  routers/      acttrace.py  keys.py
  services/     acttrace_service.py  acttrace_classification_service.py
                acttrace_notice_service.py  acttrace_constants.py
                api_key_service.py
  repositories/ acttrace_repository.py  api_key_repository.py
  schemas/      acttrace.py
  mcp_server/   server.py  __main__.py  context.py  tools/acttrace.py
skill/acttrace/ SKILL.md  README.md
tests/

支持 Markdown

登录后评论