项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器实现,专注于提供与 Monad 测试网的交互能力。它允许连接的 AI 模型(LLM 客户端)通过标准协议调用各种区块链相关的功能,将复杂的链上操作转化为 LLM 可以理解和执行的工具调用。

主要功能点

通过此 MCP 服务器,AI 模型可以执行以下与 Monad 测试网相关的操作:

  • 查询余额: 获取指定 Monad 测试网地址的 MON 代币余额。
  • 发送交易: 从配置的账户向指定地址发送 MON 代币。
  • 部署合约: 在 Monad 测试网上部署智能合约。
  • 监听事件: 查询智能合约已发生的特定事件日志。
  • 查询 NFT: 获取指定 NFT(ERC721 标准)的所有者和元数据 URI 等信息。
  • 获取最新区块: 查询 Monad 测试网的最新区块高度、哈希、时间戳等详细信息。
  • 通过区块号查询: 根据指定的区块号获取对应区块的详细信息。

安装步骤

要构建和运行此 MCP 服务器,请按照以下步骤操作:

  1. 克隆仓库: 使用 Git 将项目仓库克隆到您的本地计算机:
    git clone https://github.com/lispking/monad-mcp-server.git
  2. 进入项目目录: 切换到新克隆的项目文件夹:
    cd monad-mcp-server
  3. 安装依赖: 使用 pnpm、npm 或 yarn 安装项目所需的依赖包:
    pnpm i
    # 或者 npm install
    # 或者 yarn install
  4. 构建项目: 编译 TypeScript 代码:
    pnpm build
    # 或者 npm run build
    # 或者 yarn build
  5. 配置私钥: 复制项目根目录下的 '.env.example' 文件并重命名为 '.env'。编辑 '.env' 文件,将 Monad 测试网账户的私钥填入 'PRIVATE_KEY' 环境变量中。请注意,此私钥将用于发送交易和部署合约,请务必使用测试网账户的私钥,并妥善保管,切勿提交包含私钥的 '.env' 文件到版本控制。

服务器配置

本 MCP 服务器通过 Stdio 协议与 LLM 客户端通信。要在支持 MCP 的 LLM 客户端中使用此服务器,您需要在客户端的 MCP 服务器配置中添加以下信息。具体的配置方式取决于您的 LLM 客户端软件。

  • 服务器名称:您可以为此服务器指定一个易于识别的名称,例如 'monad-mcp'。
  • 启动命令 ('command'): 指向 Node.js 可执行文件的路径,通常为 'node'。
  • 命令参数 ('args'): 一个包含服务器启动脚本路径的数组。例如,如果您的项目构建后入口文件位于 '/path/to/your/project/build/index.js',则参数应配置为 '["/path/to/your/project/build/index.js"]'。请将 '/path/to/your/project' 替换为您的实际项目根目录路径。
  • 环境变量 ('env'): 一个包含服务器所需环境变量的对象。您需要在此处提供 Monad 测试网账户的私钥,例如 '{ "PRIVATE_KEY": "您的Monad测试网账户私钥" }'。请使用您在 '.env' 文件中配置的私钥。

基本使用方法

配置完成后,启动支持 MCP 的 LLM 客户端。客户端将根据配置自动启动 Monad MCP 服务器,并与之建立通信。LLM 模型现在可以通过 MCP 协议调用服务器提供的工具(如前面“主要功能点”中列出的工具名称),例如请求获取地址余额或发送交易,服务器将执行相应的链上操作并将结果返回给 LLM。

信息

分类

开发者工具