XAPS MCP Server

Xaps SDK

自律型エージェントのための認知的サーキットブレーカー

Xaps は、自律型 AI エージェント向けの経済的セキュリティレイヤーです。スマートコントラクトの実行、送金、または金融上のアクションを行う前に、エージェントは Xaps を呼び出して、独立した 2 つのエージェントによる監査を受けます。標準的な 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. エージェントキーを環境変数に設定します（推奨：設定ファイルへの秘密情報の保存を避けられます）。

   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 クローンからローカル開発を行う場合は、代わりに XAPS_MCP_DEV=1 を設定して python /path/to/xaps_mcp_server.py を使用してください。

   完全な例：examples/mcp_claude_desktop_config.json

4. エージェントのプロンプトに次を記述します。

   send_transaction、approve、または deposit を呼び出す前に、action、contract_address、amount を指定して xaps_audit を呼び出してください。

エージェントルールのテンプレート：examples/.agentrc

---

設定

変数	デフォルト	説明
XAPS_AGENT_KEY	—	エージェントの課金キー（コンストラクター引数の代替）
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 で実行されるエージェント向けの非同期版です。

Sink 導入の呼び水 — audit_then_query / query_sink

Tollbooth のレシートを受け取った後、エージェントは補助金付きの 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（任意のヘルパー）

---

課金

• 監査の成功 1 回につき $0.01 USD。プリペイド残高から差し引かれます
• エージェントキーへのチャージは xaps.network で行えます

---

開発

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

ソブリンノード（xap-sovereign-node）は非公開です。この公開リポジトリには SDK のみが含まれています。

---

セキュリティ

Xaps エージェントキーは課金用の識別子であり、暗号学的な秘密情報ではありません。バージョン管理にコミットしないでください。

ライセンス

MIT — LICENSE をご覧ください。