ActTrace MCP server
✓ VerifiziertKlassifiziert KI-Features unter dem EU AI Act und erstellt Transparenzhinweise gemäß Artikel 50 für Nicht-Finanztechnologieunternehmen.
Auch bekannt als goww7/acttrace, acttrace-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 Tage
- 95
- Neueste Version
- 0.1.0
- Letzter Commit
- 20. Mai 2026
- Lizenz
- Apache-2.0
Was ist ActTrace MCP?
ActTrace ist ein MCP server. Klassifiziert KI-Features unter dem EU AI Act und erstellt Transparenzhinweise gemäß Artikel 50 für Nicht-Finanztechnologieunternehmen.
Zusammenfassung generiert aus dem README des Projekts
Über ActTrace MCP server
ActTrace bietet einen automatisierten Workflow für Nicht-Finanztechnologieunternehmen, um die Compliance mit dem EU AI Act zu verwalten. Engineering-Teams können dieses Tool nutzen, um deterministische Risikoklassifizierungen für spezifische KI-Features zu erhalten und fertige Transparenzhinweise gemäß Artikel 50 zu generieren. Der Service ist speziell für den SaaS- und Tech-Sektor konzipiert, was bedeutet, dass Finanzdienstleistungen wie Banking oder Credit Scoring bewusst als out of scope eingestuft werden.
Entwickler können mit dem System über einen lokalen MCP server via uvx oder als Claude Code Plugin interagieren. Der MCP server fungiert als Offline-Rules-Engine, die für die lokale Nutzung keinen API-Key benötigt, während die vollständige API einen X-API-Key für authentifizierte Requests erfordert. Das System enthält einen kostenlosen Diagnostic-Endpoint, der keine Authentifizierung erfordert, sodass Teams ihre Features testen können, bevor sie die Tools für Klassifizierung oder die Generierung von Hinweisen nutzen.
Was du damit machen kannst
- 1KI-Risikostufen bestimmenLass die KI klassifizieren, ob ein spezifisches Chatbot-Feature unter bestimmte Risikokategorien des EU AI Act fällt.
- 2Transparenzdokumentation entwerfenFordere die Generierung eines leicht verständlichen Artikels 50 Hinweises für ein Support-Assistant-Tool an.
- 3Erste Compliance-Checks durchführenFühre einen kostenlosen Diagnostic für ein neues KI-Feature aus, um zu sehen, wie es kategorisiert werden könnte, ohne einen API-Key zu verwenden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du ActTrace MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenActTrace MCP in Claude Code installieren
$ claude mcp add acttrace -- uvx acttrace-mcpActTrace MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}ActTrace MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"acttrace": {
"type": "stdio",
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}ActTrace MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"acttrace","type":"stdio","command":"uvx","args":["acttrace-mcp"]}'ActTrace MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}ActTrace MCP in Codex installieren
$ codex mcp add acttrace -- uvx acttrace-mcpActTrace MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.acttrace] command = "uvx" args = ["acttrace-mcp"]
ActTrace MCP in Gemini CLI installieren
$ gemini mcp add -s user acttrace uvx -- acttrace-mcpActTrace MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"acttrace": {
"command": "uvx",
"args": [
"acttrace-mcp"
]
}
}
}Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbargoww7/acttrace is public and reachablegithub.com/goww7/acttrace ↗Bestanden
- Paket nennt dieses Repository als Quelleacttrace-mcp names goww7/acttrace as sourcepypi.org/project/acttrace-mcp/ ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-05-20github.com/goww7/acttrace ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from acttrace-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten41 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenActTrace
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 Fragen
Wie füge ich ActTrace MCP zu Claude Code hinzu?
Führe claude mcp add acttrace -- uvx acttrace-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich ActTrace MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Bietet ActTrace Rechtsberatung an?
Nein, ActTrace bietet Unterstützung bei Compliance-Workflows und Entwürfe für Dokumentationen, stellt aber keine Rechtsberatung bereit und zertifiziert keine Compliance.
Ist ActTrace für Finanzdienstleistungen geeignet?
Nein, ActTrace ist speziell auf Nicht-Finanzunternehmen zugeschnitten; Finanz-Use-Cases sind bewusst als out of scope klassifiziert.
Wie kann ich ActTrace mit Claude nutzen?
Du kannst es als Claude Code Plugin oder über einen lokalen MCP server nutzen, der mit uvx ausgeführt wird.