Monad MCP 服务器

Name: Monad MCP Server
Author: Semutireng22

许可证：MIT Node.js 版本

该项目提供了一个 MCP 服务器，可与 Monad 测试网无缝交互。它支持查询区块链数据（余额、交易、Gas 价格、区块），并与 CoinflipGame 智能合约交互以进行抛硬币游戏。该服务器与 Claude Desktop 集成，允许用户使用自然语言执行命令。

支持的功能及其使用方法

特征	描述	示例命令
获取周一余额	检查 Monad 测试网地址的 MON 余额。	`check MON 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
获取代币余额	检查某个地址的特定 ERC-20 代币的余额。	`check token balance for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contract 0x1234...5678`
获取交易详情	通过哈希值检索有关交易的详细信息。	`get details for transaction 0xabcdef1234567890...`
获取 gas 价格	获取 Monad 测试网上的当前 gas 价格。	`what is the current gas price`
获取最新区块	获取有关 Monad 测试网上最新区块的信息。	`show latest block info`
获取多个余额	检查一个地址的多个代币的余额。	`check multiple balances for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contracts 0x1234...5678, 0x5678...1234`
发送	将 MON 代币发送到 Monad 测试网上的指定地址。	`send 0.1 MON to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765`
发送令牌	从代币合约将 ERC-20 代币发送到指定地址。	`send 100 USDT to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765 from contract 0x1234...5678`
玩抛硬币游戏	玩抛硬币游戏，押注 MON 押正面或反面（最低赌注：0.01 MON）。	`flip 0.1 mon head`
获取硬币翻转历史记录	查看某个地址的抛硬币游戏的历史记录，包括胜利、失败和利润。	`history flip`或`history flip 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
股权-aprmon	在 Apriori 质押平台中质押您的 MON 代币。	`stake 0.1 mon`来质押 MON 代币。
取消质押-aprmon	从 Apriori 平台取消所有 MON 代币。	`unstake aprmon`即可解除所有已抵押的 MON 代币。请记下请求 ID，稍后领取时会用到。
索赔-aprmon	领取待处理的未抵押 MON 代币。	解除质押 10 分钟后，使用`claim aprmon requestID` 。 `requestID`请使用解除质押过程中获取的 ID 进行替换。
交换	为 Monad Testnet 网络集成 Uniswap V2 交换功能	对于已上线代币： `swap 0.1 MON to USDT` 。对于未上线代币： `swap 0.1 MON to 0xxxxxxxxxxx` （使用合约地址）

Related MCP server: MCP Etherscan Server

快速入门

克隆存储库

git clone https://github.com/Semutireng22/mcp-monad.git
cd mcp-monad
npm install

将 .env.example 复制到 .env 并进行配置

cp .env.example .env

使用你的私钥编辑 .env

nano .env

构建并运行

npm run build
node build/index.js

先决条件

Node.js（v16 或更高版本）
npm 或 yarn
Claude Desktop（用于 MCP 客户端集成）
一个 Monad 测试网钱包，具有足够的 MON 用于交易和 gas 费用（play-coinflip、send-mon 和 send-token 所需）
一个配置了以下内容的.env文件：Monad 测试网钱包Uniswap V2合约地址（ UNISWAP_ROUTER_ADDRESS 、 UNISWAP_FACTORY_ADDRESS ）的PRIVATE_KEY以及WMON合约地址(WMON_ADDRESS)

配置和使用

MCP 服务器初始化

在src/index.ts文件中，服务器使用支持的功能列表进行初始化：

const server = new McpServer({
  name: "monad-testnet",
  version: "0.0.1",
  capabilities: [
    "get-mon-balance",
    "get-token-balance",
    "get-transaction-details",
    "get-gas-price",
    "get-latest-block",
    "get-multiple-balances",
    "send-mon",
    "send-token",
    "play-coinflip",
    "get-coinflip-history",
    "stake-aprmon",
    "unstake-aprmon",
    "claim-aprmon",
    "get-aprmon-balance",
    "get-aprmon-rate",
    "get-aprmon-requests",
    "swap"
  ]
});

设置环境

要配置服务器，请复制示例环境文件并编辑它：

cp .env.example .env

使用文本编辑器（例如， nano 、 vim或VS Code ）编辑.env文件以包含以下内容：

PRIVATE_KEY=0xyourprivatekeyhere
UNISWAP_ROUTER_ADDRESS=0xfb8e1c3b833f9e67a71c859a132cf783b645e436
UNISWAP_FACTORY_ADDRESS=0x733e88f248b742db6c14c0b1713af5ad7fdd59d0
WMON_ADDRESS=0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701

将0xyourprivatekeyhere替换为您的 Monad 测试网钱包的私钥（以0x开头的 64 个十六进制字符）。

确保.env文件是安全的，并且尚未提交到版本控制中。将其添加到.gitignore中：

echo .env >> .gitignore

构建并运行服务器

构建项目：

npm run build

运行 MCP 服务器：

node build/index.js

与 Claude Desktop 集成

打开 Claude 桌面。
前往Settings > Developer 。
编辑claude_desktop_config.json (通常位于~/.config/Claude/或%APPDATA%\Claude\ ) 并添加以下配置：

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": [
        "/path/to/mcp-monad/build/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

将/path/to/mcp-monad/替换为项目目录的实际路径（例如，Windows 上的E:\proyek\mcp-monad或 Linux 上的/home/user/mcp-monad ）。

重新启动 Claude Desktop。
出现提示时，允许 MCP 访问聊天会话（ Allow for This Chat ）。

贡献

分叉项目
创建你的功能分支（ git checkout -b feature/AmazingFeature ）
提交您的更改（ git commit -m 'Add some AmazingFeature' ）
推送到分支（ git push origin feature/AmazingFeature ）
打开拉取请求

执照

根据 MIT 许可证分发。更多信息请参阅LICENSE 。

接触

Slamettttt - @caridipesbuk

项目链接： https://github.com/Semutireng22/mcp-monad

笔记

确保 CoinflipGame 合约 ( 0x664e248c39cd70Fa333E9b2544beEd6A7a2De09b ) 的池子里有足够的资金来支付play-coinflip的潜在收益。您可以使用 Monad 测试网区块浏览器进行检查。
对于不同系统的用户，请相应地调整claude_desktop_config.json中的项目路径。

故障排除

服务器启动失败：检查 Claude Desktop（ Settings > Developer ）或终端中的日志，查找类似“文件.env不存在”的错误。确保.env位于项目根目录中，并具有有效的PRIVATE_KEY 。
合约资金不足：使用区块浏览器验证 CoinflipGame 合约余额。合约所有者可以通过fundGamePool函数为其注入资金。
Claude 命令不起作用：确保claude_desktop_config.json具有正确的项目路径并重新启动 Claude Desktop。
TypeScript 错误：运行npx tsc检查错误。使用以下命令更新依赖项：

npm install

使用 MCP Inspector 进行调试：

git clone https://github.com/modelcontextprotocol/inspector
cd inspector
npm install
npm start

Monad MCP Server