AAAA-Nexus

Name: aaaa-nexus-mcp
Author: AAAA-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

您的智能体已经在编写代码、做出决策并消耗代币。但它无法独立完成以下操作：

证明其输出并非幻觉。
在偏差累积前检测到偏差。
与集群中的其他成员共享 LoRA 适配器。
当其修复方案训练了下一个模型时获得奖励。
获取带有来源凭证的可信 RAG 上下文。
在防篡改的 lint 检查 + 信任评分基础上对其自身的提交进行门控。
基于交付成果托管支付。
为欧盟 AI 法案附件 IV、GDPR 第 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	信任预言机	`/v1/oracle/hallucination`, `/v1/trust/decay`	针对任何文本的幻觉 + 偏差判定
2	共享 LoRA 循环	`/v1/lora/contribute`, `/v1/lora/reward/claim`	贡献修复方案赚取奖励；拉取社区适配器
3	可信 RAG	`/v1/rag/augment`, `/v1/aibom/drift`	带有收据的来源门控检索
4	系统原语	`/v1/sys/trust_gate`, `/v1/sys/lint_gate`, `/v1/sys/chain_parity`	用于智能体自我治理的数值不变量
5	合规证书	`/v1/compliance/eu-ai-act`, `/v1/compliance/explain`	欧盟 AI 法案、GDPR 第 22 条、NIST 一致性
6	托管 + SLA	`/v1/escrow/create`, `/v1/sla/report`	基于成果的 USDC 结算及仲裁
7	VeriRand	`/v1/rng/quantum`, `/v1/vrf/draw`	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/json

MCP 插件、Python SDK、npm 包以及您自己的 curl 调用都访问相同的接口。没有 SDK 锁定，没有专有线路格式，除了 Bearer 头之外无需任何额外操作。

增强架构提示词模式

AAAA-Nexus 记录了三种操作模式，您可以利用它们将任何 LLM 转变为连接到信任 + LoRA + RAG 堆栈的自我改进型智能体：

DADA — 委托 Atomadic 开发者智能体（路由任务，在独立通道中验证）
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 获取设置清单，并参阅 examples/mcp _configs/ 获取 Cursor、Claude Desktop、VS Code、Zed 和 Windsurf 的配置。

2. Python

pip install aaaa-nexus-mcp

import 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-client

import { 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。

配置

变量	默认值	用途
`AAAA_NEXUS_API_KEY`	(无)	付费工具的 Bearer 令牌
`AAAA_NEXUS_BASE_URL`	`https://atomadic.tech`	API 基础 URL
`AAAA_NEXUS_TIMEOUT`	`20.0`	请求超时（秒）
`AAAA_NEXUS_AUTOGUARD`	`1`	使用幻觉 + 偏差判定注释每个响应

无需密钥即可工作的免费层级端点：/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/python _quickstart.py
examples/typescript _quickstart.ts
examples/curl _quickstart.sh
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 授权范围。

aaaa-nexus-mcp