Azeth MCP 服务器

关键词

模型上下文协议智能合约账户区块链支付XMTP 消息服务发现

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个基于 Model Context Protocol (MCP) 的后端服务器，用于 Azeth 生态系统。服务器向 LLM 客户端提供经过标准化封装的工具集合、可查询的资源以及可渲染的提示模板，全部通过 JSON-RPC 风格的工具调用暴露。

  • 主要功能点

    • 工具（Tools）：提供多达 32 种工具，覆盖账户、转账、支付、协议、声誉、消息、 guardian 等领域，支持对接区块链智能合约、支付网关、订阅服务等能力。
    • 资源与提示（Prompts）：工具描述中包含示例提示以及可供 LLM 调用的参数描述，便于灵活产出对话上下文。
    • 会话与能力声明：服务器进行会话管理，能够在不同工具间共享或隔离能力，确保对外暴露的能力集可扩展。
    • 传输与兼容：实现基于 MCP 的 JSON-RPC 风格通信，内部实现对接 Stdio 传输，理论上也可扩展到 WebSocket/SSE 等传输方式。
    • 安全与私钥管理：提供自动私钥生成功能（若未提供 AZETH_PRIVATE_KEY，将在首次启动时生成并持久化；不可选时在内存中生成，启动日志中会给出地址信息）。

  • 安装步骤

    • 克隆仓库并安装依赖。
    • 构建源码以生成可运行的 MCP 服务器程序（通常使用 pnpm build）。
    • 启动服务器（默认通过标准输入输出传输通信，即 Stdio 传输）。
    • 如需与 Claude 等客户端集成，在客户端配置中指向该 MCP 服务器的命令和入口。

  • 服务器配置（MCP 客户端配置须包含 server name、command、args）

    • serverName: @azeth/mcp-server
    • command: npx
    • args: ["@azeth/mcp-server"]
    • 说明：这是 MCP 客户端用来调用服务器的最小组合。若需要生产环境，请在配置中指定 AZETH_PRIVATE_KEY、AZETH_SERVER_URL、AZETH_CHAIN 等环境变量，确保私钥管理、服务器端点访问及链信息正确配置。
    • 示例（文字描述，非代码格式）：
      1. 服务器名称：@azeth/mcp-server
      2. 启动命令：npx
      3. 启动参数：["@azeth/mcp-server"]
      4. 额外参数可选：包含 AZETH_PRIVATE_KEY、AZETH_SERVER_URL、AZETH_CHAIN、XMTP 加密等环境变量，用于认证、服务器定位及消息通道。

  • 基本使用方法

    • 启动方式
      • 通过零配置的 Key 生成器，若未设置 AZETH_PRIVATE_KEY，系统会在首次启动时自动生成一个私钥并持久化（若不可持久化则在内存中临时使用），并输出对应的公钥/地址信息。
      • 随后服务器以标准输入输出的传输方式对外提供 MCP 服务入口。
    • 客户端对接
      • 使用 MCP 客户端（如 Claude 微信账本/Code 插件等）向服务器发起 JSON-RPC 风格的请求，请求格式需包含工具名称及其参数，服务器返回结构化的 JSON-RPC 响应。
    • 常用操作
      • 通过 azeth_create_account、azeth_balance、azeth_transfer、azeth_pay 等工具，完成账户、资金、支付、订阅等操作。
      • 通过 azeth_get_registry_entry、azeth_discover_services 等工具进行服务发现与注册信息查询。
      • 使用 azeth_subscribe_service、azeth_create_payment_agreement 等接口完成订阅与定期支付配置。
    • 调试与日志
      • 构建并启动后，遵循 MCP 的标准日志输出与工具返回格式，遇到错误时，错误信息会通过统一的错误处理器进行脱敏处理，以避免敏感信息泄露。

  • 备注

    • 本实现包含完整的工具注册、请求处理、错误处理与结果包装逻辑，符合 MCP 服务器的核心职责。
    • 代码覆盖面涉及账户、支付、订阅、守护、声誉、消息等领域，具备较完整的行业场景适配能力。

服务器信息

访问项目