返回 MCP 目录
public公开dns本地运行

monad-bridge-mcp-server

一个轻量级的MCP服务器,通过Wormhole桥接实现以太坊Sepolia测试网与Monad测试网之间的资产跨链转移功能,支持查询余额、跨链转账等操作。

article

README

🚀 Monad Bridge MCP 服务端

Monad Bridge MCP 服务端是一个轻量级的模型上下文协议(MCP)服务器,它借助 Wormhole 桥接,实现了 Ethereum Sepolia 与 Monad 测试网之间的桥接功能。此 MCP 会与 Monadbridge 和 Wormholes API 进行交互。

🚀 快速开始

克隆仓库

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

构建并运行

npm run build

✨ 主要特性

此 MCP 服务器提供了一系列实用工具,具体如下:

| 工具名称 | 描述 | 命令 | |----------------------------------|-------------------------------------------------------------|--------------| | get-wallet-address | 使用私钥获取钱包地址。 | 显示我的钱包地址 | | get-eth-balance | 检查 Sepolia 测试网上的 ETH 余额。 | 查看我们的 ETH 余额 | | get-mon-balance | 检查 Monad 测试网上的 MON 余额。 | 查看我们的 MONAD 余额 | | bridge-sepolia-wmon-to-monad | 将 Sepolia 上的 wMON(包裹的 MON)桥接到 Monad。 | 桥接 1 wmon sepolia 到 monad | | bridge-monad-to-sepolia-wmon | 将 Monad 上的 MON 桥接到 Sepolia 上的 wMON。 | 桥接 1 monad 到 sepolia | | get-wmon-sepolia-balance | 检查 Sepolia 上的包裹的 MON(wMON)余额。 | 查看我们在 sepolia 的 wmon 余额 | | get-10-last-bridge-transaction| 获取并查看最近 10 次从 Sepolia 到 Monad 或从 Monad 到 Sepolia 的桥接交易。 | 获取最近 10 笔桥接交易获取最近桥接|

📦 安装指南

先决条件

  • Node.js (v16 或更高版本)
  • npm 或 yarn
  • Claude Desktop(用于 MCP 客户端集成)

配置步骤

  1. 下载并安装 Claude Dekstop。
  2. 打开 Claude Dekstop。
  3. 转到 设置 > 开发人员
  4. 打开配置文件,编辑 claude_desktop_config.json
  5. 添加以下配置:
{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": ["<your-local-path>monad-bridge-mcp-server\\build\\index.js"],
      "env": {
        "PRIVATE_KEY": "<your-private-key>" 
      }
    }
  }
}
  1. <your-local-path>monad-bridge-mcp-server\\build\\index.js 替换为实际的项目目录路径(例如 E:\data\monad-bridge-mcp-server\build\index.js/path/to/monad-bridge-mcp-server/build/index.js)。
  2. 按照提示完成配置。

💻 使用示例

基础用法

以下是使用 MCP 服务器工具的完整示例:

  1. 克隆仓库并安装依赖:
git clone https://github.com/rawakinode/monad-bridge-mcp-server.git
cd monad-bridge-mcp-server
npm install
  1. 构建项目:
npm run build
  1. 配置 Claude Desktop:
    • 打开 claude_desktop_config.json
    • 添加以下内容:
      {
        "mcpServers": {
          "monad-mcp": {
            "command": "node",
            "args": ["E:\\data\\monad-bridge-mcp-server\\build\\index.js"],
            "env": {
              "PRIVATE_KEY": "your_private_key_here"
            }
          }
        }
      }
      
    • 保存文件。
  2. 使用命令行工具:
    get-wallet-address
    # 输出:0xYourWalletAddress
    
    bridge-sepolia-wmon-to-monad 1
    # 桥接 1 个 wmon 到 Monad
    
    get-10-last-bridge-transaction
    # 获取最近 10 笔桥接交易记录
    

命令说明

显示我的钱包地址

get-wallet-address

查看我们的 ETH 余额

get-eth-balance

查看我们的 MONAD 余额

get-mon-balance

桥接 wmon 到 Monad

bridge-sepolia-wmon-to-monad <amount>

桥接 monad 到 Sepolia

bridge-monad-to-sepolia-wmon <amount>

查看 wmon 余额(Sepolia)

get-wmon-sepolia-balance

获取最近桥接交易

get-10-last-bridge-transaction

📚 详细文档

截图说明

以下是截图的中文说明:

图 1: 配置界面

Config Interface

图 2: 命令行工具示例

Command Line Example

图 3: 桥接过程

Bridge Process

⚠️ 注意事项

⚠️ 重要提示

  • 确保私钥安全,避免泄露。
  • 在生产环境中使用前,请务必备份配置文件。
  • 如果遇到问题,请检查日志或联系支持团队。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端