XAPS MCP Server

Xaps SDK

自主 Agent 的认知断路器

Xaps 是面向自主 AI Agent 的经济安全层。在执行智能合约、转账或金融操作之前，你的 Agent 会调用 Xaps 进行独立的双 Agent 审计。标准 Web3 工具会验证签名——Xaps 会验证意图和逻辑。

---

安装

pip install xaps-sdk

或从此仓库安装：

pip install "xaps-sdk @ git+https://github.com/APMC1/[email protected]"

快速入门

from xaps import XapsClient, XapsRejectedError

client = XapsClient(api_key="your_agent_key")

receipt = client.audit(
    action="execute_smart_contract",
    contract_address="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    amount=1000.0,
)

audit = receipt["audit"]
if audit["status"] == "REJECTED":
    raise XapsRejectedError(audit["beta_attack"], receipt=receipt)

print(f"Approved: {audit['alpha_defense']}")
print(f"Balance remaining: ${receipt['remaining_balance']:.2f}")

异步

from xaps import XapsClient

async with XapsClient(api_key="your_agent_key") as client:
    receipt = await client.audit_async(
        action="execute_smart_contract",
        contract_address="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
        amount=1000.0,
    )

---

MCP 集成

使用 XAPS MCP 服务，从 Claude Desktop、Cursor 或任何 MCP 宿主审计高风险操作。 完整设置说明请参阅 docs/mcp-host-integration.md。

60 秒内开始使用 xaps_audit

1. 安装（会提供 xaps-mcp 控制台命令）：

   pip install xaps-sdk
   

2. 在环境中设置你的 Agent 密钥（推荐——避免将密钥保存在配置文件中）：

   export XAPS_AGENT_KEY="your_agent_key"
   

3. 添加到 Claude Desktop 配置（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

   {
     "mcpServers": {
       "xaps-audit": {
         "command": "xaps-mcp"
       }
     }
   }
   

   如果从 git 克隆进行本地开发，请改用 python /path/to/xaps_mcp_server.py，并设置 XAPS_MCP_DEV=1。

   完整示例：examples/mcp_claude_desktop_config.json

4. 在你的 Agent 提示词中：

   在调用任何 send_transaction、approve 或 deposit 之前：使用 action、contract_address 和 amount 调用 xaps_audit。

Agent 规则模板：examples/.agentrc

---

配置

变量	默认值	描述
XAPS_AGENT_KEY	—	Agent 计费密钥（可替代构造函数参数）
XAPS_API_URL	https://api.xaps.network	API 基础 URL

# Or pass explicitly
client = XapsClient(api_key="...", base_url="https://api.xaps.network")

---

API 参考

XapsClient(api_key=None, base_url=..., timeout=10.0)

创建客户端。如果未提供 API 密钥，则会引发 ValueError。

client.audit(action, contract_address, amount, payload_override=None)

同步审计。返回回执字典：

{
  "xaps_receipt": true,
  "agent_key": "...",
  "remaining_balance": 9.99,
  "audit": {
    "status": "APPROVED",
    "alpha_defense": "...",
    "beta_attack": "..."
  }
}

await client.audit_async(...)

适用于运行在 asyncio 上的 Agent 的异步版本。

Sink 采用引导器——audit_then_query / query_sink

收到 Tollbooth 回执后，Agent 可以调用补贴的 Sink 获取真实的结构化数据（GitHub / HTTP）。这就是集成的吸引点：通道 → 实用功能。

from xaps import XapsClient

with XapsClient() as client:
    # One shot: fast/swarm audit for query_oracle, then sink
    result = client.audit_then_query(
        "github repo anthropics/anthropic-sdk-python",
        oracle_url="http://localhost:8766",  # or XAPS_ORACLE_URL
    )
    print(result["sink"]["data"])

    # Or reuse an existing receipt
    receipt = client.audit_auto("query_oracle", "", 0.01)
    data = client.query_sink("search github MCP agents", receipt)

环境变量：XAPS_ORACLE_URL（Sink 基础 URL）、XAPS_API_URL + XAPS_AGENT_KEY（Tollbooth）。

MCP：xaps_audit_then_query、xaps_sink_query、xaps_sink_health。

异常

异常	发生条件
XapsAuthError	API 密钥无效或缺失（401）
XapsPaymentError	预付余额不足（402）
XapsRateLimitError	请求过多（429）
XapsAPIError	其他 API 错误
XapsRejectedError	审计返回 REJECTED（可选辅助项）

---

计费

• 每次成功审计收费 $0.01 USD，从预付余额中扣除
• 在 xaps.network 为你的 Agent 密钥充值

---

开发

git clone https://github.com/APMC1/xaps-sdk.git
cd xaps-sdk
pip install -e ".[dev]"
pytest

主权节点（xap-sovereign-node）为私有。本公开仓库仅包含 SDK。

---

安全

你的 Xaps Agent 密钥是计费标识符，而非加密密钥。请勿将其提交到版本控制系统。

许可证

MIT — 参阅 LICENSE。