aaaa-nexus-mcp
OfficialAAAA-Nexus
신뢰할 수 있는 에이전트를 위한 개발자 인프라. 신뢰, 보안, 규정 준수, RAG, 결제 및 에이전트 오케스트레이션을 아우르는 19개 카테고리의 140개 MCP 도구.
pip install aaaa-nexus-mcp # Python + Claude / Cursor / Codex MCP
npm install @atomadic/nexus-client # TypeScript / Node / Deno / Bun
curl https://atomadic.tech/health # or skip the SDK entirely무료 티어는 키가 필요하지 않습니다. 유료 기능을 사용하려면 atomadic.tech/pay에서 키를 받으세요.
에이전트가 AAAA-Nexus를 직접 호출하는 이유
에이전트는 이미 코드를 작성하고, 결정을 내리며, 토큰을 소비하고 있습니다. 에이전트가 스스로 할 수 없는 것들:
자신의 출력이 환각(hallucination)이 아님을 증명하기.
드리프트(drift)가 복합적으로 발생하기 전에 감지하기.
스웜(swarm)의 나머지 부분과 LoRA 어댑터를 공유하기.
자신의 수정 사항이 다음 모델을 학습시킬 때 보상을 받기.
출처 증명 영수증과 함께 신뢰할 수 있는 RAG 컨텍스트 가져오기.
변조 방지 린트(lint) 및 신뢰 점수를 기반으로 자신의 커밋을 게이트하기.
결과 기반 전달에 대한 결제 에스크로 설정하기.
EU AI 법 Annex IV, GDPR Art. 22 및 NIST AI-RMF에 대한 추적 인증하기.
AAAA-Nexus는 이 모든 것을 수행합니다. HTTP 계층에서. 단 한 번의 호출로 말이죠.
중요한 두 가지 플라이휠
1. 공유 LoRA — 코딩하면서 수익 창출
에이전트가 생성하는 모든 (buggy_code → fix) 쌍은 학습 샘플입니다. 이를 공유 풀에 기여하면 다음과 같은 혜택을 얻을 수 있습니다:
할인 또는 무료 API 호출 (평판 등급별 가격 책정)
승인된 샘플 마일스톤에 대한 경품 추첨
리더보드 배치 (atomadic.tech에서 확인 가능)
귀하의 언어에 대한 커뮤니티 학습 어댑터 액세스
루프는 네 번의 호출로 이루어집니다:
from aaaa_nexus_mcp.client import NexusAPIClient
async with NexusAPIClient(api_key="an_...") as c:
# 1. Capture locally (free, PII-scrubbed, hash-chained)
await c.post("/v1/lora/capture", {"bad": bad, "good": good, "language": "python"})
# 2. Contribute the buffered batch (micro-rebate per accepted sample)
await c.post("/v1/lora/contribute", {"min_quality": 0.6})
# 3. Pull the current community adapter
adapter = await c.get("/v1/lora/adapter/python")
# 4. Claim your reputation reward
await c.post("/v1/lora/reward/claim", {"agent_id": "my-agent-001"})엔드 투 엔드 스크립트는 examples/lora_flywheel.py를 참조하세요.
2. 신뢰할 수 있는 RAG 주기 — 증명이 없으면 발생하지 않은 것
일반적인 RAG는 벡터 인덱스가 반환하는 것은 무엇이든 가져옵니다. 신뢰할 수 있는 RAG는 각 청크를 다음 기준으로 게이트합니다:
소스 도메인 허용 목록
신선도 윈도우
검색된 텍스트에 대한 환각 오라클 판정
라이브 지식 그래프 대비 드리프트 점수
변조 방지 영수증 (계보 저장소에 SHA-256으로 체인 연결)
ctx = await c.post("/v1/rag/augment", {
"query": "latest EU AI Act Annex IV requirements",
"max_results": 5,
"freshness_hours": 168,
"source_policy": "trusted_only",
"required_domains": ["europa.eu", "nist.gov"],
})
# ctx["results"][i] includes: text, source_url, trust_score, receipt_hash모든 응답은 _guard 블록과 함께 제공됩니다: {hallucination, drift, guarded_at}. 직접 이러한 검사를 실행할 필요가 없습니다.
인증서 발행을 포함한 전체 주기는 examples/trusted_rag.py를 참조하세요.
주요 기능
# | 기능 | 대표 엔드포인트 | 해결하는 문제 |
1 | 신뢰 오라클 |
| 모든 텍스트에 대한 환각 및 드리프트 판정 |
2 | 공유 LoRA 루프 |
| 수정 사항 기여로 보상 획득; 커뮤니티 어댑터 가져오기 |
3 | 신뢰할 수 있는 RAG |
| 영수증이 포함된 출처 게이트 검색 |
4 | 시스템 기본 요소 |
| 에이전트 자치 관리를 위한 수치적 불변량 |
5 | 규정 준수 인증 |
| EU AI 법, GDPR Art. 22, NIST 적합성 |
6 | 에스크로 + SLA |
| 중재가 포함된 결과 기반 USDC 결제 |
7 | VeriRand |
| HMAC 증명 무작위성, 온체인 VRF 추첨 |
총합: 19개 카테고리에 걸친 140개 도구. 카테고리별 상세 내역은 현재 카탈로그의 공개 진실 소스인 docs/TOOLS.md에 있습니다.
에이전트가 직접 호출하는 인프라
하나의 기본 URL. Bearer 인증. JSON 입력 / JSON 출력. 모든 응답은 이미 보호되어 있습니다.
POST https://atomadic.tech/v1/<category>/<verb>
Authorization: Bearer an_your_key
Content-Type: application/jsonMCP 플러그인, Python SDK, npm 패키지 및 직접 작성한 curl 호출 모두 동일한 인터페이스를 사용합니다. SDK 종속성, 독점적인 와이어 형식, Bearer 헤더 외에 필요한 절차는 없습니다.
향상된 아키텍처 프롬프트 패턴
AAAA-Nexus는 모든 LLM을 신뢰 + LoRA + RAG 스택에 연결된 자기 개선 에이전트로 전환하는 데 사용할 수 있는 세 가지 운영 패턴을 문서화합니다:
DADA— Delegator Atomadic Developer Agent (작업을 라우팅하고 별도의 레인에서 검증)Atomadic— 의도 해석기 및 프롬프트 정제기Autopoetic— 자기 치유 피드백 루프
에이전트가 nexus_* 도구를 의도적으로 사용하도록 하려면 CLAUDE.md, .cursorrules 또는 시스템 프롬프트 필드에서 이를 시작점으로 사용하세요.
퀵스타트 — 경로 선택
1. Claude Code / Cursor / VS Code (MCP)
한 번 설치:
pip install aaaa-nexus-mcp~/.claude/settings.json 또는 프로젝트 .mcp.json에 추가:
{
"mcpServers": {
"aaaa-nexus": {
"command": "python",
"args": ["-m", "aaaa_nexus_mcp"],
"env": {
"AAAA_NEXUS_API_KEY": "an_your_key_here",
"AAAA_NEXUS_AUTOGUARD": "1"
}
}
}
}편집기를 다시 시작하세요. 이제 140개의 모든 도구를 채팅에서 nexus_*로 사용할 수 있습니다. 설정 체크리스트는 docs/ONBOARDING.md를, Cursor, Claude Desktop, VS Code, Zed 및 Windsurf용 설정은 examples/mcp_configs/를 참조하세요.
2. Python
pip install aaaa-nexus-mcpimport asyncio
from aaaa_nexus_mcp.client import NexusAPIClient
async def main():
async with NexusAPIClient(api_key="an_...") as c:
verdict = await c.post("/v1/oracle/hallucination",
{"text": "The moon is made of Swiss cheese."})
print(verdict) # {"verdict": "unsafe", "policy_epsilon": ..., "_guard": {...}}
asyncio.run(main())전체 스크립트: examples/python_quickstart.py.
3. TypeScript / Node / Deno / Bun
npm install @atomadic/nexus-clientimport { NexusClient } from "@atomadic/nexus-client";
const nexus = new NexusClient({ apiKey: process.env.AAAA_NEXUS_API_KEY });
const verdict = await nexus.oracle.hallucination({ text: "The moon is made of Swiss cheese." });
console.log(verdict);전체 스크립트: examples/typescript_quickstart.ts. 더 넓은 클라이언트 인터페이스는 docs/INTEGRATION.md를 참조하세요.
4. curl (모든 언어)
curl -sS https://atomadic.tech/v1/oracle/hallucination \
-H "Authorization: Bearer $AAAA_NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"The moon is made of Swiss cheese."}'전체 스크립트: examples/curl_quickstart.sh.
구성
변수 | 기본값 | 목적 |
| (없음) | 유료 도구용 Bearer 토큰 |
|
| API 기본 URL |
|
| 요청 타임아웃 (초) |
|
| 모든 응답에 환각 + 드리프트 판정 주석 달기 |
키 없이 작동하는 무료 티어 엔드포인트: /health, /v1/rng/quantum, /v1/agent/card, /v1/metrics.
문서
docs/MCP_HTTP_SERVER.md — HTTP MCP 서버 (스트리밍 가능한 HTTP, 사양 2025-11-25) — 무설치, 7개 핵심 도구, x402 결제, Claude Desktop HTTP 구성
docs/MCP_CLIENTS.md — stdio 패키지용 편집기별 설정 (Claude, Cursor, VS Code, Zed, Windsurf)
docs/INTEGRATION.md — 언어별 통합 가이드
docs/TOOLS.md — 140개 도구 인터페이스에 대한 도구 인덱스 및 가격 참조
docs/LORA_REWARDS.md — 보상 프로그램, 리더보드, 경품 메커니즘
docs/TRUSTED_RAG.md — RAG 주기, 출처, 영수증 형식
예제
examples/lora_flywheel.py — 보상 획득 루프
examples/trusted_rag.py — 출처 게이트 검색
examples/agent_self_gate.py — 자신의 커밋을 게이트하는 에이전트
examples/mcp_configs/ — 모든 MCP 편집기용 드롭인 구성
라이선스
소스 패키지: MIT. 생성된 OpenAPI 스키마: CC BY-ND 4.0.
MIT는 이 저장소의 콘텐츠(Python 패키지, MCP 연결, 예제 및 여기에 제공된 공개 문서)에 적용됩니다. 호스팅되는 AAAA-Nexus 서비스, 백엔드 구현, 모델/증명, 가격 책정 인터페이스 및 atomadic.tech 사이트 콘텐츠는 이 저장소와 별개이며 별도로 라이선스가 부여되거나 독점적일 수 있습니다. Atomadic, AAAA-Nexus 및 관련 이름, 로고 및 브랜딩은 MIT 하에 부여되지 않습니다.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Atomadic MCP: 68 deterministic tools for agent identity, escrow, SLA, EU AI Act compliance.
AI Agent Trust Stack MCP: Veritas Proof-Chain Notary, Machine Credit Bureau, Firewall & Grader.
Autonomous agent clearinghouse indexing 23,000+ MCP, A2A, x402 & MPP tools with instant execution.
113 MCP tools: oracle, escrow, compliance, remittance, AI. 12 free tools, PAYG $0.001/call.