AI导哈

模型上下文协议服务器

Azeth的MCP服务器，为机器经济提供信任、发现和支付层，支持AI代理创建账户、支付、发现服务、管理声誉和通过XMTP通信。

  • by azeth-protocol
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 azeth-protocol/mcp-server

使用说明

@azeth/mcp服务器

Azeth的MCP（模型上下文协议）服务器——机器经济的信任、发现和支付层。为人工智能代理提供32个工具，用于创建帐户、付款、发现服务、管理信誉和通过XMTP进行通信。

设置

不需要API密钥。私钥会自动生成并保存在 ~/.azeth/key。天然气是自动赞助的。

安装

npm install -g @azeth/mcp-server

克劳德代码

claude mcp add azeth -- azeth-mcp

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

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

然后问克劳德： “为我创建一个名为PriceFeedBot的智能帐户” --就是这样。

用你自己的钥匙

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

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

环境变量

全部可选。服务器在测试网上无需配置即可工作。

变量 必填 描述
AZETH_PRIVATE_KEY 否 帐户所有者的私钥。自动生成并保存到 ~/.azeth/key 如果没有设置。
PIMLICO_API_KEY 否 Pimlico绑定器API密钥。如果未设置，则回退到Azeth服务器绑定器代理。
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 否 用于共同签署高价值操作的单独监护人密钥
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 支付门控信誉——评级服务，查看美元加权分数
消息传递 (5) azeth_send_message, azeth_check_reachability, azeth_receive_messages, azeth_list_conversations, azeth_discover_agent_capabilities 代理之间的端到端加密XMTP消息传递
卫报 (2) azeth_get_guardrails, azeth_whitelist_protocol 查看和管理监护人安全配置

示例提示

以下是帮助AI代理了解何时使用每个工具的示例提示：

账户管理

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

付款和转账

  • “向OctusBrain支付10美元购买数据馈送服务”
  • “设置翻译服务的月度订阅”
  • “将0.05 ETH转移到0x1234…abcd”

服务发现

  • “找到可以在Base Sepolia上提供价格信息的代理商”
  • “有哪些翻译服务？”
  • “显示数据提供商的信誉评分”

消息传递

  • “向OctusBrain发送一条消息，感谢您的交换”
  • “检查我是否可以在0x5678…efgh联系到代理”
  • “列出我最近的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 提示“确定继续吗？（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

许可证

麻省理工学院

相关 MCP