xenarch-mcp

npm License: MIT

Xenarch 支付网络的 MCP 服务器。让 AI 代理能够通过 Base 链上的 USDC 小额支付来发现并购买服务。

工作原理

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, price_usd: "0.003", protocol: "x402" }

2. Pay         xenarch_pay("example.com")
               → USDC sent on Base via splitter contract
               → { access_token: "eyJ...", expires_at: "..." }

3. Access      Re-request the URL with Authorization: Bearer <token>
               → Full content returned

无需 API 密钥。无需注册。代理直接在链上支付 —— Xenarch 从不持有资金。

代理 MCP 服务器

为 AI 代理提供的三个工具：

工具	描述
`xenarch_check_gate`	检查 URL/域名是否设有支付网关。返回定价和支付详情。
`xenarch_pay`	支付受保护的内容。通过拆分合约在 Base 链上执行 USDC 支付。
`xenarch_get_history`	查看此钱包过去的支付记录。

响应示例

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "price_usd": "0.003",
  "splitter": "0xC6D3a6B6fcCD6319432CDB72819cf317E88662ae",
  "collector": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC",
  "protocol": "x402"
}

{
  "success": true,
  "tx_hash": "0xdef456...abc789",
  "block_number": 28451023,
  "amount_usd": "0.003",
  "url": "example.com",
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "expires_at": "2026-04-10T15:05:00Z",
  "wallet": "0x123...your_wallet"
}

{
  "payments": [
    {
      "domain": "example.com",
      "amount_usd": "0.003",
      "tx_hash": "0xdef456...abc789",
      "paid_at": "2026-04-10T14:35:00Z"
    }
  ],
  "total_spent_usd": "0.003000",
  "count": 1,
  "wallet": "0x123...your_wallet"
}

设置

配置您的钱包：

mkdir -p ~/.xenarch
cat > ~/.xenarch/wallet.json << 'EOF'
{
  "privateKey": "0xYOUR_PRIVATE_KEY"
}
EOF
chmod 600 ~/.xenarch/wallet.json

添加到 Claude Code：

claude mcp add xenarch -- npx @xenarch/agent-mcp

或者添加到 Claude Desktop / 任何 MCP 客户端：

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

环境变量

变量	默认值	描述
`XENARCH_PRIVATE_KEY`	—	钱包私钥（覆盖配置文件）
`XENARCH_RPC_URL`	`https://mainnet.base.org`	Base RPC 端点
`XENARCH_API_BASE`	`https://api.xenarch.dev`	Xenarch 平台 API
`XENARCH_NETWORK`	`base`	网络（`base` 或 `base-sepolia`）
`XENARCH_AUTO_APPROVE_MAX`	—	无需提示即可自动批准的最大美元金额

示例

请参阅 xenarch-examples 获取可用的集成示例 —— 包括 Python 代理、LangChain、CrewAI、Claude Desktop 设置以及发布者中间件。

开发

npm install
npm run build

结构

packages/
  shared/    — Payment logic, types, config (reused across servers)
  agent/     — MCP server for AI agents

许可证

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Xenarch Agent MCP