🚀 Monad MCP Server

🚀 Monad MCP サーバー

Monad Testnet ネットワーク上のウォレットに関する詳細情報を提供する MCP（Monad Control Panel）サーバーです。このプロジェクトでは、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. プロジェクトをフォークします
2. 機能用のブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. 変更をプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

📄 ライセンス

このプロジェクトは ISC ライセンスの下で配布されています。詳細については、LICENSE ファイルを参照してください。

📬 お問い合わせ

LOFT228 - @github

プロジェクトのリンク：https://github.com/LOFT228/Monad-MCP-Server

---

Monad コミュニティのために ❤️ を込めて作成