项目简介

这是一个基于 Model Context Protocol (MCP) 实现的服务器端示例,旨在演示如何将 AI 智能体与 AVS (Actively Validated Services) 网络集成。它作为一个桥梁,允许 AI 调用工具获取链上相关数据,并将验证任务提交到 AVS 网络进行处理。

主要功能点

  • 获取加密货币价格: 提供一个工具,可以查询指定加密货币交易对的实时价格(例如 ETHUSDT)。
  • 提交验证任务: 提供一个工具,可以将特定的数据(如获取到的价格)作为“任务证明”提交到 AVS 网络进行链上验证或执行。
  • 链上数据交互: 通过内部服务与 AVS 网络进行交互,包括发送任务并签名。
  • IPFS集成: 使用 Pinata 服务将任务相关数据发布到 IPFS,生成任务证明的哈希。

安装步骤

  1. 克隆仓库到本地:
    git clone https://github.com/Othentic-Labs/avs-mcp-example.git
    cd avs-mcp-example
  2. 全局安装 Othentic CLI:
    npm i -g @othentic/othentic-cli
  3. 进入 MCP 服务器目录并构建项目:
    cd MCP_Execution_Server
    npm i
    npm run build

服务器配置

该 MCP 服务器需要由 MCP 客户端(如 Claude Desktop)启动和连接。您需要在客户端的配置文件(例如 'claude_desktop_config.json')中添加如下配置项,告诉客户端如何启动这个服务器进程。

配置示例 (JSON 格式,请勿直接作为代码运行):

{
  "mcpServers": {
    "AVSPerformer": { // 给您的MCP服务器起一个名字,用于在客户端中识别
      "command": "node", // 启动服务器的命令
      "args": [ // 启动命令的参数
        "ADD_ABSOLUTE_PATH/avs-mcp-example/MCP_Execution_Server/build/index.js" // MCP服务器的启动脚本路径,请将 ADD_ABSOLUTE_PATH 替换为仓库在你本地的绝对路径
      ],
      "env": { // 启动服务器进程时需要设置的环境变量
        "PRIVATE_KEY_PERFORMER": "YOUR_PERFORMER_PRIVATE_KEY_HERE", // 执行AVS任务的以太坊账户私钥,请替换为您的私钥
        "OTHENTIC_CLIENT_RPC_ADDRESS": "http://localhost:8545", // AVS网络的RPC地址,通常是运行AVS节点的本地地址
        "PINATA_API_KEY": "YOUR_PINATA_API_KEY_HERE", // Pinata API Key,用于将数据发布到IPFS,请替换
        "PINATA_SECRET_API_KEY": "YOUR_PINATA_SECRET_API_KEY_HERE" // Pinata Secret API Key,请替换
      }
    }
  }
}

请根据您的实际情况修改 'args' 中的路径和 'env' 中的私钥、RPC地址以及 Pinata Keys。

基本使用方法

  1. 确保您的 AVS 网络正在运行,并且按照上述步骤配置了 MCP 客户端(如 Claude Desktop)。
  2. 启动您的 MCP 客户端。客户端将根据配置自动启动并连接到 AVS MCP 服务器。
  3. 在连接了此 MCP 服务器的客户端中,您可以使用自然语言与智能体互动,调用服务器提供的工具和 Prompt。

示例 Prompt:

  • 获取价格:'can you get the price of ETHUSDT?' (询问智能体获取 ETHUSDT 价格)
  • 提交任务:'can you validate this price using AVS network?' (询问智能体将之前获取的价格提交到 AVS 网络进行验证)

您可以通过查看 AVS 网络的 Attestation Center 合约来验证链上任务的执行结果。

信息

分类

AI与计算