ActTrace MCP server
✓ 인증됨EU AI Act에 따라 AI 기능을 분류하고 비금융 기술 기업을 위한 Article 50 투명성 고지서를 생성합니다.
다른 이름 goww7/acttrace, acttrace-mcp
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- 95
- 최신 버전
- 0.1.0
- 마지막 커밋
- 2026년 5월 20일
- 라이선스
- Apache-2.0
ActTrace MCP란?
ActTrace은(는) MCP server입니다. EU AI Act에 따라 AI 기능을 분류하고 비금융 기술 기업을 위한 Article 50 투명성 고지서를 생성합니다.
프로젝트 README에서 생성된 요약
ActTrace MCP server 정보
ActTrace는 비금융 기술 기업이 EU AI Act 컴플라이언스를 관리할 수 있도록 자동화된 워크플로우를 제공합니다. 엔지니어링 팀은 이 도구를 사용하여 특정 AI 기능에 대한 결정론적 위험 분류를 수행하고, 즉시 배포 가능한 Article 50 투명성 고지서를 생성할 수 있습니다. 이 서비스는 SaaS 및 기술 분야를 위해 특별히 설계되었으므로, 은행이나 신용 점수 산정 같은 금융 서비스는 의도적으로 범위 외로 분류합니다.
개발자는 uvx를 통해 실행되는 로컬 MCP server 또는 Claude Code 플러그인을 통해 시스템과 상호작용할 수 있습니다. MCP server는 로컬 사용 시 API key가 필요 없는 오프라인 규칙 엔진으로 작동하며, 전체 API를 사용하려면 인증된 요청을 위한 X-API-Key가 필요합니다. 시스템에는 인증이 필요 없는 무료 진단 엔드포인트가 포함되어 있어, 팀이 분류 또는 고지서 생성 도구를 본격적으로 사용하기 전에 기능을 테스트해 볼 수 있습니다.
활용 사례
- 1AI 위험 수준 결정특정 챗봇 기능이 EU AI Act의 특정 위험 범주에 해당하는지 AI에게 분류하도록 요청합니다.
- 2투명성 문서 초안 작성지원 어시스턴트 도구를 위한 쉬운 언어의 Article 50 고지서 생성을 요청합니다.
- 3초기 컴플라이언스 점검 수행API key 없이 새로운 AI 기능에 대해 무료 진단을 실행하여 어떻게 분류될지 확인합니다.
프로젝트의 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ActTrace가 법률 자문을 제공하나요?
아니요, ActTrace는 운영 컴플라이언스 워크플로우 지원 및 문서 초안을 제공하지만, 법률 자문을 제공하거나 컴플라이언스 인증을 수행하지는 않습니다.
ActTrace를 금융 서비스에 사용할 수 있나요?
아니요, ActTrace는 비금융 기업을 대상으로 설계되었습니다. 금융 관련 사용 사례는 의도적으로 범위 외(out of scope)로 분류됩니다.
Claude에서 ActTrace를 어떻게 사용하나요?
Claude Code 플러그인으로 사용하거나 uvx로 실행되는 로컬 MCP server를 통해 사용할 수 있습니다.