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