aaaa-nexus-mcp
OfficialAAAA-Nexus
Entwickler-Infrastruktur für vertrauenswürdige Agenten. 140 MCP-Tools in 19 Kategorien für Vertrauen, Sicherheit, Compliance, RAG, Zahlungen und Agenten-Orchestrierung.
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 entirelyFür die kostenlose Stufe ist kein Schlüssel erforderlich. Holen Sie sich einen unter atomadic.tech/pay, wenn Sie die kostenpflichtige Oberfläche nutzen möchten.
Warum Agenten AAAA-Nexus direkt aufrufen
Ihr Agent schreibt bereits Code, trifft Entscheidungen und gibt Token aus. Was er nicht von alleine kann:
Beweisen, dass seine Ausgaben nicht halluziniert sind.
Abweichungen (Drift) erkennen, bevor sie sich verstärken.
Einen LoRA-Adapter mit dem Rest des Schwarms teilen.
Belohnungen verdienen, wenn seine Korrekturen das nächste Modell trainieren.
Vertrauenswürdigen RAG-Kontext mit Herkunftsnachweisen abrufen.
Seine eigenen Commits durch ein manipulationssicheres Linting + Vertrauens-Score absichern.
Eine Zahlung bei ergebnisbasierter Lieferung treuhänderisch hinterlegen.
Seine Trace für EU-KI-Gesetz Anhang IV, DSGVO Art. 22 und NIST AI-RMF zertifizieren.
AAAA-Nexus erledigt all das. Auf der HTTP-Ebene. Mit einem Aufruf.
Die zwei entscheidenden Schwungräder
1. Shared LoRA — verdienen, während Sie programmieren
Jedes (fehlerhafter_code → korrektur)-Paar, das Ihr Agent produziert, ist ein Trainingsbeispiel. Tragen Sie es zum gemeinsamen Pool bei und Sie erhalten im Gegenzug:
Rabattierte oder kostenlose API-Aufrufe (Preise basierend auf Reputationsstufen)
Gewinnspiele bei erreichten Meilensteinen für Beispiele
Platzierung in der Bestenliste (sichtbar auf atomadic.tech)
Zugriff auf den Community-trainierten Adapter für Ihre Sprache
Die Schleife besteht aus vier Aufrufen:
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"})Siehe examples/lora_flywheel.py für das End-to-End-Skript.
2. Trusted RAG-Zyklus — Herkunftsnachweis oder es ist nicht passiert
Gewöhnliches RAG ruft ab, was auch immer der Vektor-Index zurückgibt. Trusted RAG schützt jeden Chunk durch:
Quell-Domain-Allowlist
Aktualitätsfenster
Halluzinations-Orakel-Urteil über den abgerufenen Text
Drift-Score gegenüber dem Live-Wissensgraphen
Manipulationssichere Quittung (SHA-256 verkettet mit dem Lineage-Vault)
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_hashJede Antwort wird mit einem _guard-Block ausgeliefert: {hallucination, drift, guarded_at}. Sie müssen diese Prüfungen nie selbst durchführen.
Siehe examples/trusted_rag.py für den vollständigen Zyklus einschließlich der Zertifikatsausstellung.
Hauptfunktionen
# | Funktion | Repräsentative Endpunkte | Was es löst |
1 | Vertrauens-Orakel |
| Halluzinations- und Drift-Urteile für jeden Text |
2 | Shared LoRA-Schleife |
| Belohnungen für Korrekturen verdienen; Community-Adapter abrufen |
3 | Trusted RAG |
| Herkunftsgeschützter Abruf mit Quittungen |
4 | System-Primitive |
| Numerische Invarianten für die Selbstverwaltung von Agenten |
5 | Compliance-Zertifikate |
| EU-KI-Gesetz, DSGVO Art. 22, NIST-Konformität |
6 | Treuhand + SLA |
| Ergebnisbasierte USDC-Abrechnung mit Schiedsverfahren |
7 | VeriRand |
| HMAC-bewiesene Zufälligkeit, On-Chain VRF-Ziehungen |
Gesamt: 140 Tools in 19 Kategorien. Die genaue Aufschlüsselung nach Kategorien finden Sie in docs/TOOLS.md, der öffentlichen Quelle der Wahrheit für den aktuellen Katalog.
Infrastruktur, die Agenten direkt aufrufen
Eine Basis-URL. Bearer-Authentifizierung. JSON rein / JSON raus. Jede Antwort ist bereits geschützt.
POST https://atomadic.tech/v1/<category>/<verb>
Authorization: Bearer an_your_key
Content-Type: application/jsonDas MCP-Plugin, das Python-SDK, das npm-Paket und Ihre eigenen curl-Aufrufe nutzen alle dieselbe Oberfläche. Kein SDK-Lock-in, kein proprietäres Übertragungsformat, keine erforderliche Zeremonie außer einem Bearer-Header.
Enhancement Architect Prompt-Muster
AAAA-Nexus dokumentiert drei Betriebsmuster, mit denen Sie jeden LLM in einen selbstverbessernden Agenten verwandeln können, der mit dem Trust + LoRA + RAG-Stack verbunden ist:
DADA— Delegator Atomadic Developer Agent (leitet Aufgaben weiter, verifiziert in einer separaten Spur)Atomadic— Absichts-Interpreter & Prompt-VerfeinererAutopoetic— Selbstheilende Feedback-Schleife
Verwenden Sie diese als Ausgangspunkte in Ihrer CLAUDE.md, .cursorrules oder im System-Prompt-Feld, wenn der Agent nexus_*-Tools gezielt einsetzen soll.
Schnellstarts — wählen Sie Ihren Weg
1. Claude Code / Cursor / VS Code (MCP)
Einmal installieren:
pip install aaaa-nexus-mcpFügen Sie dies zu ~/.claude/settings.json oder project .mcp.json hinzu:
{
"mcpServers": {
"aaaa-nexus": {
"command": "python",
"args": ["-m", "aaaa_nexus_mcp"],
"env": {
"AAAA_NEXUS_API_KEY": "an_your_key_here",
"AAAA_NEXUS_AUTOGUARD": "1"
}
}
}
}Starten Sie den Editor neu. Alle 140 Tools sind nun als nexus_* in Ihrem Chat verfügbar. Siehe docs/ONBOARDING.md für die Einrichtungs-Checkliste und examples/mcp_configs/ für Cursor, Claude Desktop, VS Code, Zed und Windsurf.
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())Vollständiges Skript: 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);Vollständiges Skript: examples/typescript_quickstart.ts. Siehe docs/INTEGRATION.md für die breitere Client-Oberfläche.
4. curl (jede Sprache)
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."}'Vollständiges Skript: examples/curl_quickstart.sh.
Konfiguration
Variable | Standard | Zweck |
| (keiner) | Bearer-Token für kostenpflichtige Tools |
|
| API-Basis-URL |
|
| Request-Timeout (Sekunden) |
|
| Jede Antwort mit Halluzinations- und Drift-Urteilen annotieren |
Endpunkte der kostenlosen Stufe, die ohne Schlüssel funktionieren: /health, /v1/rng/quantum, /v1/agent/card, /v1/metrics.
Dokumentation
docs/MCP_HTTP_SERVER.md — HTTP MCP-Server (Streamable HTTP, Spezifikation 2025-11-25) — Zero-Install, 7 Kern-Tools, x402-Zahlung, Claude Desktop HTTP-Konfiguration
docs/MCP_CLIENTS.md — Editor-für-Editor-Einrichtung für das stdio-Paket (Claude, Cursor, VS Code, Zed, Windsurf)
docs/INTEGRATION.md — Sprach-für-Sprache-Integrationsleitfaden
docs/TOOLS.md — Tool-Index und Preisreferenzen für die 140-Tool-Oberfläche
docs/LORA_REWARDS.md — Belohnungsprogramm, Bestenliste, Gewinnspielmechaniken
docs/TRUSTED_RAG.md — RAG-Zyklus, Herkunftsnachweis, Quittungsformat
Beispiele
examples/lora_flywheel.py — Belohnungsschleife
examples/trusted_rag.py — Herkunftsgeschützter Abruf
examples/agent_self_gate.py — Agent, der seine eigenen Commits absichert
examples/mcp_configs/ — Drop-in-Konfigurationen für jeden MCP-Editor
Lizenz
Quellpaket: MIT. Generiertes OpenAPI-Schema: CC BY-ND 4.0.
MIT gilt für die Inhalte dieses Repositorys: das Python-Paket, die MCP-Verkabelung, Beispiele und die hier bereitgestellten öffentlichen Dokumente. Der gehostete AAAA-Nexus-Dienst, die Backend-Implementierung, Modelle/Proofs, Preisoberflächen und die Inhalte der atomadic.tech-Website sind von diesem Repository getrennt und können separat lizenziert oder proprietär sein. Atomadic, AAAA-Nexus und zugehörige Namen, Logos und Branding sind nicht unter MIT lizenziert.
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.