使用说明
项目简介
本项目是一个基于 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)。
安装步骤
-
克隆仓库:
git clone https://github.com/monad-developers/monad-mcp-tutorial.git cd monad-mcp-tutorial -
安装依赖:
npm install -
构建项目:
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"'。
基本使用方法
-
启动 MCP 服务器: 当 MCP 客户端 (如 Claude Desktop) 启动并加载配置后,服务器将自动启动。无需手动运行服务器,它会作为客户端的子进程运行。
-
在 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