使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器,旨在演示如何构建一个能够与 Monad 测试网交互的 MCP 服务器。该服务器提供了一个名为 'get-mon-balance' 的工具,允许 LLM 客户端查询指定 Monad 测试网地址的 MON 代币余额。

主要功能点

  • 提供工具 (Tools): 实现了 'get-mon-balance' 工具,用于查询 Monad 测试网地址的 MON 代币余额。
  • MCP 服务器: 基于 '@modelcontextprotocol/sdk/server' SDK 构建,符合 MCP 协议规范,能够与 MCP 客户端进行通信。
  • 标准 JSON-RPC 通信: 使用标准输入/输出 (stdio) 作为传输协议,通过 JSON-RPC 与 MCP 客户端交互。
  • 易于集成: 提供了清晰的配置步骤,方便将该 MCP 服务器集成到支持 MCP 协议的 LLM 客户端 (如 Claude Desktop)。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/monad-developers/monad-mcp-tutorial.git
    cd monad-mcp-tutorial
  2. 安装依赖:

    npm install
  3. 构建项目:

    npm run build

    构建成功后,'index.js' 文件将生成在 'build' 目录下。

服务器配置

要将此 MCP 服务器添加到 MCP 客户端(例如 Claude Desktop),您需要配置客户端的 MCP 服务器列表。以下是添加到 'claude_desktop_config.json' 文件的配置示例:

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": [
        "/<path-to-project>/build/index.js"  // 将 "/<path-to-project>" 替换为项目 build 目录的实际路径
      ]
    }
  }
}

配置说明:

  • '"monad-mcp"': 服务器名称,在客户端中用于标识和引用此服务器。可以自定义。
  • '"command": "node"': 启动服务器的命令,这里使用 Node.js 运行时环境。
  • '"args"': 启动命令的参数数组。
    • '"/<path-to-project>/build/index.js"': 指向构建后的 'index.js' 文件路径。请务必将 '/<path-to-project>' 替换为您的 'monad-mcp-tutorial' 项目在您本地文件系统中的绝对路径。 例如,如果您的项目在 '/Users/username/Documents/monad-mcp-tutorial',则应修改为 '"/Users/username/Documents/monad-mcp-tutorial/build/index.js"'。

基本使用方法

  1. 启动 MCP 服务器: 当 MCP 客户端 (如 Claude Desktop) 启动并加载配置后,服务器将自动启动。无需手动运行服务器,它会作为客户端的子进程运行。

  2. 在 LLM 中调用工具: 在支持 MCP 协议的 LLM 客户端中,您可以指示 LLM 使用 'get-mon-balance' 工具来查询 MON 代币余额。例如,在 Claude Desktop 中,您可以输入类似如下的指令:

    请查询地址 0x5A0b54D5dc17e0AadC383d2db43B0a0D3E029c4c 的 MON 代币余额。

    LLM 客户端会识别到 'get-mon-balance' 工具,并调用 MCP 服务器执行查询,并将结果返回给您。

注意: 请确保您已正确配置 MCP 客户端,并将 'claude_desktop_config.json' 文件放置在 Claude Desktop 可以读取的位置。具体位置请参考 Claude Desktop 的文档。

信息

分类

网页与API