ActTrace MCP server
✓ VerifiedMengklasifikasikan fitur AI berdasarkan EU AI Act dan membuat notifikasi transparansi Pasal 50 untuk perusahaan teknologi non-finansial.
Juga dikenal sebagai goww7/acttrace, acttrace-mcp
- Stars
- 1
- Tools
- —
- Unduhan, 30 hari
- 195
- Versi terbaru
- 0.1.0
- Commit terakhir
- 20 Mei 2026
- Lisensi
- Apache-2.0
Apa itu ActTrace MCP?
Mengklasifikasikan fitur AI berdasarkan EU AI Act dan membuat notifikasi transparansi Pasal 50 untuk perusahaan teknologi non-finansial.
Ringkasan dibuat dari README proyek
Tentang ActTrace MCP server
ActTrace menyediakan workflow otomatis bagi perusahaan teknologi non-finansial untuk mengelola kepatuhan terhadap EU AI Act. Tim engineering dapat menggunakan tool ini untuk mendapatkan klasifikasi risiko yang deterministik untuk fitur AI tertentu dan menghasilkan notifikasi transparansi Pasal 50 yang siap digunakan. Layanan ini dirancang khusus untuk sektor SaaS dan teknologi, yang berarti layanan finansial seperti perbankan atau penilaian kredit sengaja dikategorikan di luar cakupan.
Developer dapat berinteraksi dengan sistem melalui local MCP server yang dijalankan via uvx atau sebagai plugin Claude Code. MCP server beroperasi sebagai rules engine offline yang tidak memerlukan API key untuk penggunaan lokal, sementara API lengkap memerlukan X-API-Key untuk request yang terautentikasi. Sistem ini menyertakan endpoint diagnostik gratis yang tidak memerlukan autentikasi, memungkinkan tim untuk menguji fitur mereka sebelum menggunakan tool klasifikasi atau pembuatan notifikasi.
Apa yang bisa Anda lakukan dengannya
- 1Menentukan level risiko AIMinta AI untuk mengklasifikasikan apakah fitur chatbot tertentu masuk ke dalam kategori risiko EU AI Act tertentu.
- 2Membuat draf dokumentasi transparansiMinta pembuatan notifikasi Pasal 50 dengan bahasa yang mudah dipahami untuk tool asisten dukungan.
- 3Melakukan pengecekan kepatuhan awalJalankan diagnostik gratis pada fitur AI baru untuk melihat bagaimana fitur tersebut dikategorikan tanpa perlu menggunakan API key.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal ActTrace MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal ActTrace MCP di Claude Code
$ claude mcp add acttrace -- uvx acttrace-mcpInstal ActTrace MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}Instal ActTrace MCP di VS Code
.vscode/mcp.json
{
"servers": {
"acttrace": {
"type": "stdio",
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}Instal ActTrace MCP di VS Code CLI
$ code --add-mcp '{"name":"acttrace","type":"stdio","command":"uvx","args":["acttrace-mcp"]}'Instal ActTrace MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}Instal ActTrace MCP di Codex
$ codex mcp add acttrace -- uvx acttrace-mcpInstal ActTrace MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.acttrace] command = "uvx" args = ["acttrace-mcp"]
Instal ActTrace MCP di Gemini CLI
$ gemini mcp add -s user acttrace uvx -- acttrace-mcpInstal ActTrace MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaugoww7/acttrace is public and reachablegithub.com/goww7/acttrace ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaacttrace-mcp names goww7/acttrace as sourcepypi.org/project/acttrace-mcp/ ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-05-20github.com/goww7/acttrace ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from acttrace-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya41 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubActTrace
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/
Pertanyaan tentang ActTrace MCP
Bagaimana cara menambahkan ActTrace MCP ke Claude Code?
Jalankan claude mcp add acttrace -- uvx acttrace-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan ActTrace MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah ActTrace memberikan nasihat hukum?
Tidak, ActTrace menyediakan dukungan workflow kepatuhan operasional dan draf dokumentasi, namun tidak memberikan nasihat hukum atau sertifikasi kepatuhan.
Apakah ActTrace cocok untuk layanan keuangan?
Tidak, ActTrace dikhususkan untuk perusahaan non-finansial; penggunaan di sektor finansial sengaja dikategorikan di luar cakupan (out of scope).
Bagaimana cara menggunakan ActTrace dengan Claude?
Anda dapat menggunakannya sebagai plugin Claude Code atau melalui local MCP server yang dijalankan dengan uvx.