MCP Monad

🚀 MCP 单体

MCP（Model Context Protocol）是用于连接人工智能模型与外部数据源的协议。本项目基于 Monad 框架实现了 MCP 服务器，支持多种实用功能模块，能为用户提供多样化的服务。

🚀 快速开始

克隆项目

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

配置环境变量

复制示例环境文件并编辑：

cp .env.example .env

在文本编辑器中打开 .env 文件，填入以下内容：

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

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

确保 .env 文件不在版本控制系统中，并添加到 .gitignore：

echo .env >> .gitignore

构建与运行

构建项目：

npm run build

启动 MCP 服务器：

node build/index.js

✨ 主要特性

Coinflip 游戏

通过合约地址 0x664e248c39cd70Fa333E9b2544beEd6A7a2De09b 运行的掷硬币游戏，为用户带来趣味体验。

Staking 机制

支持用户质押代币获取收益，相关操作如下：

• stake-aprmon：进行质押
• unstake-aprmon：解除质押
• claim-aprmon：领取收益

Swap 交易

集成 Uniswap 协议，允许用户在 Monand 网络上进行代币交换，满足用户的交易需求。

📦 安装指南

环境要求

• 操作系统：支持 Node.js 的任意系统（Windows、Linux、macOS）
• Node.js：版本 14 及以上
• npm/yarn：版本 6 及以上

安装步骤

按照快速开始部分的步骤进行操作，即可完成项目的安装与启动。

📚 详细文档

项目结构

mcp-monad/
├── src/
│   ├── server.ts
│   └── modules/
│       ├── coinflip/
│       │   └── game.ts
│       ├── stake/
│       │   └── aprmon.ts
│       └── swap/
│           └── uniswap.ts
├── build/
│   └── index.js
└── .env.example

集成到 Claude Desktop

1. 打开 Claude 桌面应用。
2. 进入 设置 > 开发者 菜单。
3. 编辑 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/ 替换为项目实际路径（例如：E:\proyek\mcp-monad Windows 或 /home/user/mcp-monad Linux）。 4. 重启 Claude Desktop。 5. 在提示时，允许 MCP 服务在当前聊天会话中使用权限（选择 Allow for This Chat）。

贡献指南

1. 创建分支：为新功能创建特征分支（例如：git checkout -b feature/AmazingFeature）。
2. 提交代码：记录修改内容（如：git commit -m 'Add some AmazingFeature'）。
3. 推送变更：将分支推送到远程仓库（如：git push origin feature/AmazingFeature）。
4. 创建拉取请求：在 GitHub 上发起合并请求。

📄 许可证

本项目遵循 MIT License 协议。

📞 联系方式

• 作者：Semutireng
• 邮箱：semu@monand.org
• GitHub：Semutireng/mcp-monad

⚠️ 注意事项

依赖管理

• 确保所有依赖项已正确安装。
• 使用 npm install 或 yarn install 进行安装。

钱包配置

• 私钥需妥善保管，避免泄露。
• 建议在测试环境中使用测试网代币。

合约地址验证

• 确认所有合约地址正确无误。
• 在正式使用前建议进行多轮测试。

安全注意事项

• 保持代码库的安全性，定期进行安全审计。
• 更新依赖项时检查是否有已知漏洞。

通过以上步骤，您将能够成功运行并集成 MCP 单体服务器到 Monand 网络中。