项目简介

这是一个轻量级的 Model Context Protocol (MCP) 服务器实现，旨在通过 Wormhole 跨链桥接功能，连接以太坊 Sepolia 测试网和 Monad 测试网。它为支持 MCP 的 LLM 客户端（如 Claude Desktop）提供了一系列区块链相关的工具，方便用户通过自然语言查询钱包信息、余额以及执行跨链操作。

主要功能点

查询钱包地址: 显示与配置的私钥关联的以太坊地址。
查询余额: 查询您的地址在 Sepolia 测试网上的 ETH 余额、在 Monad 测试网上的 MON 余额以及在 Sepolia 上的 Wrapped MON (WMON) 代币余额。
跨链桥接:
- 将 Sepolia 测试网上的 WMON 代币桥接到 Monad 测试网上的原生 MON。
- 将 Monad 测试网上的原生 MON 桥接到 Sepolia 测试网上的 WMON 代币。
查询交易: 获取最近 10 条与您的地址相关的 Sepolia <-> Monad 跨链桥交易记录。

安装步骤

确保您已安装 Node.js (版本 16 或更新) 和 npm 或 yarn。

从 GitHub 克隆项目仓库：

git clone https://github.com/rawakinode/monad-bridge-mcp-server.git
cd monad-bridge-mcp-server

安装项目依赖：
```
npm install
```
构建项目：
```
npm run build
```

服务器配置

该 MCP 服务器需要通过支持 MCP 的客户端启动。以下是配置 Claude Desktop (或其他 MCP 客户端) 启动此服务器所需的信息：

您需要在客户端的配置文件（例如 'claude_desktop_config.json'）的 'mcpServers' 部分添加一个条目。该条目是一个 JSON 对象，包含服务器的名称、启动命令、参数以及必要的环境变量。

服务器名称: 'monad-mcp' (建议使用此名称以便识别)
启动命令 (command): 'node' (用于执行 Node.js 脚本)
参数 (args): 一个包含脚本路径的数组，例如 '["<你的本地路径>/monad-bridge-mcp-server/build/index.js"]'。请将 '<你的本地路径>' 替换为您的项目实际存放路径。在 Windows 上路径分隔符可能是 ''，在 Linux/macOS 上是 '/'。
环境变量 (env): 一个包含私钥的对象。必须包含 'PRIVATE_KEY' 字段，其值为您的钱包私钥字符串。请将 '<你的私钥>' 替换为您的实际私钥。请务必妥善保管您的私钥，不要泄露。

配置示例（概念展示，具体格式请参考客户端文档）：

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": ["<你的本地路径>/monad-bridge-mcp-server/build/index.js"],
      "env": {
        "PRIVATE_KEY": "<你的私钥>"
      }
    }
  }
}

配置完成后，请重新启动您的 MCP 客户端。

基本使用方法

确保您已经按照“安装步骤”和“服务器配置”完成了设置，并且 MCP 客户端已成功启动并连接到该服务器。
在 MCP 客户端的聊天界面中，您可以通过输入特定的指令来调用 MCP 服务器提供的工具。
当第一次使用 MCP 工具时，客户端可能会询问是否允许该会话访问 MCP 服务器，请选择允许。
根据您想执行的操作，输入以下示例指令：
- 查询钱包地址：输入 'show my wallet address'
- 查询余额：输入 'check our ETH balance, check our MONAD balance, and check our wmon balance on sepolia' (可以组合或单独输入)
- 将 WMON 从 Sepolia 桥接到 Monad：输入 'bridge <数量> wmon sepolia to monad' (例如: 'bridge 0.01 wmon sepolia to monad')
- 将 MON 从 Monad 桥接到 Sepolia WMON：输入 'bridge <数量> monad to wmon sepolia' (例如: 'bridge 0.01 monad to wmon sepolia')
- 查询最近交易：输入 'get 10 last bridge transaction' 或 'get last bridge'

服务器将执行相应的操作，并将结果（如地址、余额、交易详情或错误信息）通过客户端显示给您。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息