ActTrace MCPサーバー
✓ 検証済みEU AI Actに基づいたAI機能の分類、および非金融テクノロジー企業向けの第50条透明性通知の作成を行います。
別名 goww7/acttrace, acttrace-mcp
- スター
- 1
- ツール
- —
- ダウンロード数(30日間)
- 95
- 最新バージョン
- 0.1.0
- 最終コミット
- 2026年5月20日
- ライセンス
- Apache-2.0
ActTrace MCPとは
ActTraceはMCPサーバーです。 EU AI Actに基づいたAI機能の分類、および非金融テクノロジー企業向けの第50条透明性通知の作成を行います。.
プロジェクトのREADMEから生成された概要
ActTrace MCP server について
ActTraceは、非金融テクノロジー企業がEU AI Actへのコンプライアンスを管理するための自動化されたワークフローを提供します。エンジニアリングチームは、このツールを使用して特定のAI機能に対して決定論的なリスク分類を取得し、そのまま利用可能な第50条の透明性通知を生成できます。本サービスはSaaSおよびテクノロジーセクター向けに特別に設計されており、銀行や信用スコアリングなどの金融サービスは意図的にスコープ外として分類されています。
開発者は、uvx経由で実行するローカルのMCP server、またはClaude Codeのプラグインとしてシステムとやり取りできます。MCP serverはオフラインのルールエンジンとして動作するため、ローカルでの使用にAPI keyは不要です。一方、フルAPIを利用する場合は、認証済みリクエストのためにX-API-Keyが必要になります。システムには認証不要の無料診断エンドポイントが含まれており、分類や通知生成ツールを本格的に利用する前に、機能をテストすることが可能です。
できること
- 1AIのリスクレベルの判定特定のチャットボット機能がEU AI Actのどのリスクカテゴリに該当するかをAIに分類させます。
- 2透明性ドキュメントのドラフト作成サポートアシスタントツール向けの、平易な言葉で書かれた第50条の通知生成を依頼します。
- 3初期コンプライアンスチェックの実施新しいAI機能に対して無料の診断を実行し、API keyを使用せずにどのように分類されるかを確認します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ActTrace MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにActTrace MCPをインストール
$ claude mcp add acttrace -- uvx acttrace-mcpCursorにActTrace MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}VS CodeにActTrace MCPをインストール
.vscode/mcp.json
{
"servers": {
"acttrace": {
"type": "stdio",
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}VS Code CLIにActTrace MCPをインストール
$ code --add-mcp '{"name":"acttrace","type":"stdio","command":"uvx","args":["acttrace-mcp"]}'Claude DesktopにActTrace MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}CodexにActTrace MCPをインストール
$ codex mcp add acttrace -- uvx acttrace-mcpCodex config.tomlにActTrace MCPをインストール
~/.codex/config.toml
[mcp_servers.acttrace] command = "uvx" args = ["acttrace-mcp"]
Gemini CLIにActTrace MCPをインストール
$ gemini mcp add -s user acttrace uvx -- acttrace-mcpGemini settings.jsonにActTrace MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能goww7/acttrace is public and reachablegithub.com/goww7/acttrace ↗合格
- パッケージがこのリポジトリをソースとして指定acttrace-mcp names goww7/acttrace as sourcepypi.org/project/acttrace-mcp/ ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-05-20github.com/goww7/acttrace ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from acttrace-mcp合格
- パッケージおよびその依存関係に重大な勧告なし41 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るActTrace
A developer-facing EU AI Act compliance API for non-financial SaaS and technology companies. ActTrace gives an engineering team three things, self-serve, over an API or via MCP:
- A deterministic risk classification of an AI feature under the EU AI Act.
- A ready-to-ship Article 50 transparency notice.
- A free diagnostic as the public entry point.
Not legal advice. ActTrace provides operational compliance workflow support and documentation drafts. It does not provide legal advice, does not certify compliance, and does not replace review by qualified counsel. Every response carries this disclaimer.
ActTrace is scoped for non-financial companies. Financial-services use
cases (banking, trading, portfolio/investment advice, credit scoring, …) are
deliberately classified out_of_scope_financial_services.
Install — Claude Code plugin / MCP server
ActTrace ships as a Claude Code plugin: an acttrace skill plus a local MCP
server. The MCP server runs via uvx — a deterministic rules engine, offline,
no API key.
/plugin marketplace add goww7/acttrace
/plugin install acttrace@acttrace
Then ask Claude "Is my chatbot EU AI Act compliant?" or "Write an Article 50
notice for our support assistant." The MCP server also runs standalone with
any MCP client: uvx acttrace-mcp.
Quickstart
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"
}'
Endpoints
| Method & path | Auth | Tokens | Purpose |
|---|---|---|---|
POST /api/acttrace/diagnostics/free |
none | 0 | Public risk diagnostic |
POST /api/acttrace/classify |
key | 15 | Documented risk classification |
POST /api/acttrace/notices |
key | 10 | Article 50 transparency notice |
POST /api/keys/generate |
none | 0 | Issue a free-plan key |
GET /api/health |
none | 0 | Liveness |
Auth is X-API-Key. Responses carry X-Request-ID, X-Plan,
X-Tokens-Charged, X-Tokens-Remaining, X-RateLimit-*. Errors are
structured {"code","message","detail"} (401/403/429).
MCP
python -m acttrace.mcp_server --sse --port 8002 exposes two tools —
acttrace_classify and acttrace_generate_transparency_notice — authenticated
with the same X-API-Key. A Claude Code skill is in skill/acttrace/.
Tests
.venv/bin/python -m pytest -q
54 tests: classification engine (7 acceptance fixtures), conflict guard, notice generator, and HTTP API contract.
Deploy
docker-compose.yml builds a standalone two-container stack (API + MCP) on
ports 8080 / 8002 with its own volume — isolated from FinanceData2. To go live,
append caddy-acttrace.snippet to the shared Caddyfile (replace the
placeholder domain). See BLUEPRINT.md for the full build contract.
Layout
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/
ActTrace MCPのよくある質問
ActTrace MCPをClaude Codeに追加するには
ターミナルでclaude mcp add acttrace -- uvx acttrace-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ActTrace MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
ActTraceは法的助言を提供しますか?
いいえ、ActTraceは運用上のコンプライアンス・ワークフローのサポートとドキュメントのドラフト作成を提供しますが、法的助言の提供やコンプライアンスの認証は行いません。
ActTraceは金融サービスに適していますか?
いいえ、ActTraceは非金融企業に特化しており、銀行や信用スコアリングなどの金融関連のユースケースは意図的にスコープ外として分類されています。
ClaudeでActTraceを使用するにはどうすればよいですか?
Claude Codeのプラグインとして、またはuvxで実行するローカルのMCP server経由で使用できます。