🚀 Monad MCP Server

🚀 Monad MCP 服务

MCP（Monad Control Panel）服务，用于提供 Monad Testnet 网络中钱包的详细信息。此项目可让你通过 API 轻松获取余额和代币数据。

📋 功能

此服务可提供以下信息：

• 💰 原生代币余额（MONAD）
• 🪙 ERC-20 代币余额
• 📊 钱包基本信息
• ⚠️ 代币错误分析

🛠️ 技术

• Node.js - 服务端平台
• Express - Web 框架
• ethers.js - 区块链交互库
• Monad Testnet - Monad 测试网络

⚙️ 安装和运行

前置条件

• Node.js v16 或更高版本
• npm 或 yarn
• 连接到 Monad Testnet 的互联网访问权限

安装步骤

# Clone the repository
git clone https://github.com/LOFT228/Monad-MCP-Server.git
cd Monad-MCP-Server

# Install dependencies
npm install

# Start the server
npm start

如需在开发过程中自动重新加载：

npm run dev

🌐 API 端点

主页

GET /

返回服务和可用端点的基本信息。

钱包信息

GET /wallet/:address

返回钱包的完整信息，包括原生代币余额和所有已知的 ERC-20 代币。

原生代币余额

GET /wallet/:address/balance

仅返回原生代币余额（MONAD）。

指定代币余额

GET /wallet/:address/token/:tokenAddress

返回指定钱包中某个 ERC-20 代币的信息。

📝 响应示例

{
  "address": "0x418bF6023b30c53072bcDcc653d6e14C20ba569F",
  "nativeBalance": {
    "symbol": "MONAD",
    "name": "Monad",
    "balance": "0.121916140766047236",
    "rawBalance": "121916140766047236",
    "decimals": 18
  },
  "tokens": [
    // List of ERC-20 tokens if they exist in the wallet
  ],
  "tokenErrors": [
    // Information about errors when trying to retrieve token data
  ]
}

⚙️ 配置

服务设置位于 config.js 文件中。你可以在其中修改：

• 服务端口
• 用于连接 Monad Testnet 的 RPC URL
• 已知代币列表

module.exports = {
  PORT: 8080,
  MONAD_RPC_URL: 'https://testnet-rpc.monad.xyz/',
  TOKENS: {
    // Add real token contracts here
    'TOKEN_NAME': 'TOKEN_CONTRACT_ADDRESS'
  }
};

🔍 项目结构

mcp-monad/
├── config.js           # Project configuration
├── index.js            # Main server file
├── package.json        # Dependencies and scripts
├── utils/              # Utilities
│   └── blockchain.js   # Functions for working with blockchain
└── routes/             # API routes
    └── wallet.js       # Routes for wallet operations

🔮 未来改进

• 添加对 NFT 代币的支持
• 实现请求缓存以提升性能
• 创建用于显示信息的 Web 界面
• 添加钱包交易分析功能
• 实现钱包变更通知

🤝 参与贡献

欢迎为项目贡献！如果你有改进想法：

1. Fork 此项目
2. 为你的功能创建分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送更改（git push origin feature/amazing-feature）
5. 发起 Pull Request

📄 许可证

此项目基于 ISC 许可证发布。详情请参阅 LICENSE 文件。

📬 联系方式

LOFT228 - @github

项目链接：https://github.com/LOFT228/Monad-MCP-Server

---

为 Monad 社区倾情打造 ❤️