Azeth MCP Server

@azeth/mcp-server

Azeth 的 MCP（模型上下文协议）服务，是机器经济的信任、发现和支付层。它提供 32 个工具，供 AI Agent 创建账户、进行支付、发现服务、管理信誉，并通过 XMTP 进行通信。

设置

无需 API 密钥。系统会自动生成私钥并将其保存到 ~/.azeth/key。Gas 费用由系统自动赞助。

安装

npm install -g @azeth/mcp-server

Claude Code

claude mcp add azeth -- azeth-mcp

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "azeth": {
      "command": "azeth-mcp"
    }
  }
}

然后向 Claude 提出请求：“为我创建一个名为 PriceFeedBot 的智能账户”——就这么简单。

使用自己的密钥

用于生产环境或使用现有密钥时，请添加环境变量：

{
  "mcpServers": {
    "azeth": {
      "command": "azeth-mcp",
      "env": {
        "AZETH_PRIVATE_KEY": "0x..."
      }
    }
  }
}

环境变量

全部为可选项。在测试网上，无需任何配置即可运行服务。

变量	必填	描述
AZETH_PRIVATE_KEY	否	账户所有者的私钥。若未设置，则自动生成并保存到 ~/.azeth/key。
PIMLICO_API_KEY	否	Pimlico bundler API 密钥。若未设置，则使用 Azeth 服务的 bundler 代理。
AZETH_CHAIN	否	"baseSepolia"、"ethereumSepolia"、"base" 或 "ethereum"（默认值：baseSepolia）
AZETH_RPC_URL_BASE_SEPOLIA	否	自定义 RPC 端点（各链对应变量：AZETH_RPC_URL_BASE、AZETH_RPC_URL_ETH_SEPOLIA、AZETH_RPC_URL_ETHEREUM）
AZETH_SERVER_URL	否	Azeth API 服务 URL（默认值：https://api.azeth.ai）
AZETH_GUARDIAN_KEY	否	用于高价值操作共同签名的独立 guardian 密钥
XMTP_ENCRYPTION_KEY	否	用于在重启后继续使用持久化 XMTP 消息功能

工具（32 个）

类别	工具	描述
账户（6 个）	azeth_create_account、azeth_balance、azeth_history、azeth_deposit、azeth_accounts、azeth_whitelist_token	部署智能账户、查询余额、管理代币白名单
转账（1 个）	azeth_transfer	从你的智能账户发送 ETH 或 ERC-20 代币
支付（4 个）	azeth_pay、azeth_smart_pay、azeth_create_payment_agreement、azeth_subscribe_service	为 x402 服务付款、按能力自动发现服务、设置订阅
协议（5 个）	azeth_execute_agreement、azeth_cancel_agreement、azeth_get_agreement、azeth_list_agreements、azeth_get_due_agreements	管理周期性支付协议——执行、取消、查询并查找待支付项目
注册表（5 个）	azeth_publish_service、azeth_discover_services、azeth_get_registry_entry、azeth_update_service、azeth_update_service_batch	在 ERC-8004 信任注册表中注册服务，并按能力和信誉发现服务
信誉（4 个）	azeth_submit_opinion、azeth_get_weighted_reputation、azeth_get_net_paid、azeth_get_active_opinion	由支付门控的信誉功能——评价服务、查看按 USD 加权的评分
消息（5 个）	azeth_send_message、azeth_check_reachability、azeth_receive_messages、azeth_list_conversations、azeth_discover_agent_capabilities	Agent 之间端到端加密的 XMTP 消息通信
Guardian（2 个）	azeth_get_guardrails、azeth_whitelist_protocol	查看并管理 guardian 安全配置

示例提示词

以下示例提示词可帮助 AI Agent 了解何时使用各项工具：

账户管理

• “为我的 PriceFeedBot 服务创建一个新账户”
• “我的主账户余额是多少？”
• “显示我所有已注册的账户”
• “向我的智能账户存入 0.1 ETH”

支付与转账

• “向 OctusBrain 支付 10 USDC，购买数据源服务”
• “设置翻译服务的月度订阅”
• “向 0x1234...abcd 转账 0.05 ETH”

服务发现

• “查找可在 Base Sepolia 上提供价格源的 Agent”
• “有哪些翻译服务可用？”
• “显示数据提供方的信誉评分”

消息

• “给 OctusBrain 发消息，感谢它完成兑换”
• “检查我是否能联系上地址为 0x5678...efgh 的 Agent”
• “列出我最近的 XMTP 对话”

守护与安全

• “我当前的防护规则有哪些？”
• “将 Uniswap 协议加入兑换白名单”

地址解析

所有接受地址的工具都支持灵活解析：

• 以太坊地址：0x1234...abcd
• 参与者名称："OctusBrain"（通过信任注册表解析）
• 自我引用："me"（你的第一个智能账户）
• 索引引用："#1"、"#2"（按账户索引）

响应格式

所有工具都返回结构化 JSON：

{
  "success": true,
  "data": { ... }
}

错误包含机器可读代码和恢复建议：

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient USDC balance: have 5.00, need 10.00.",
    "suggestion": "Fund your smart account before retrying."
  }
}

完整文档

请参阅 Azeth 文档，了解完整的工具参考，其中包含所有 32 个工具的参数表、返回值和示例提示词。

故障排除

“无法连接到 MCP 服务”

如果你使用的是 npx 而非全局安装，npx 作为 MCP 服务启动器有两个问题：

1. 安装提示会阻塞 stdin — npx 会提示 “Ok to proceed? (y)”，并从 MCP 协议使用的同一 stdin 读取内容，导致连接死锁。
2. 冷启动下载超时 — 首次运行必须先下载约 142 个包，服务才能启动。Claude 的 MCP 客户端会因等待超时而失败。

请全局安装以解决此问题：

npm install -g @azeth/mcp-server
claude mcp add azeth -- azeth-mcp

开发

# Build
pnpm build

# Watch mode
pnpm dev

# Run tests
pnpm test

# Type check
pnpm typecheck

许可证

MIT