Monad MCP 服务器

该项目提供了一个 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` （使用合约地址）

快速入门

克隆存储库

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

实现与 Monad 测试网的交互以检查余额、检查交易详情、获取 gas 价格并检索区块信息。

Related MCP Servers

Flow MCP
Outblock
A
security
A
license
A
quality
Provides tools for interacting with the Flow blockchain, including Flow balance checking, token balance querying, and Cadence Owned Account information retrieval.
Last updated -
5
74
1
TypeScript
MIT License
hackle-mcpofficial
hackle-io
A
security
A
license
A
quality
A Model Context Protocol server for Hackle API providing tools and resources for querying A/B Test data.
Last updated -
76
1
JavaScript
MIT License
MCP Smart Contract Analyst
RockYuan
-
security
-
license
-
quality
Enables interaction with the Monad blockchain to analyze smart contract source code for functionality and security, with decompilation support for unverified contracts.
Last updated -
TypeScript
Apache 2.0
Monad NFT Analytics MCP
Sifu213
-
security
-
license
-
quality
A server that retrieves NFT-related data on the Monad testnet, allowing users to check NFT holders, calculate portfolio values, view collections, and track top-selling NFTs by volume and sales across different time periods.
Last updated -
TypeScript

View all related MCP servers

Monad MCP Server