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 網絡中。