モナドMCPサーバー

このプロジェクトは、Monadテストネットとのシームレスな連携を実現するMCPサーバーを提供します。ブロックチェーンデータ（残高、トランザクション、ガス価格、ブロック）のクエリと、コインフリップゲームをプレイするためのCoinflipGameスマートコントラクトとの連携をサポートします。このサーバーはClaude Desktopと統合されており、ユーザーは自然言語でコマンドを実行できます。

サポートされている機能と使用方法

Related MCP server: Monad NFT Analytics MCP

クイックスタート

• リポジトリをクローンする

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 クライアント統合用）

• トランザクションとガス料金に十分なMONを備えたMonadテストネットウォレット（play-coinflip、send-mon、send-tokenに必要）

• 以下で構成された.envファイル: MonadテストネットウォレットのPRIVATE_KEY``Uniswap V2コントラクトアドレス( UNISWAP_ROUTER_ADDRESS 、 UNISWAP_FACTORY_ADDRESS )、 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 桁の 16 進文字) に置き換えます。

.envファイルが安全であり、バージョン管理にコミットされていないことを確認してください.gitignoreに追加してください。

echo .env >> .gitignore

サーバーの構築と実行

プロジェクトをビルドします。

npm run build

MCP サーバーを実行します。

node build/index.js

Claude Desktopとの統合

1. Claude Desktop を開きます。

2. Settings > Developerに移動します。

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/プロジェクト ディレクトリへの実際のパス (例: Windows の場合はE:\proyek\mcp-monad 、Linux の場合は/home/user/mcp-monad ) に置き換えます。

4. Claude Desktop を再起動します。

5. プロンプトが表示されたら、チャット セッションに対する MCP アクセスを許可します ([ Allow for This Chat ])。

貢献

1. プロジェクトをフォークする

2. Feature ブランチを作成します ( git checkout -b feature/AmazingFeature )

3. 変更をコミットします（ git commit -m 'Add some AmazingFeature' ）

4. ブランチにプッシュする ( git push origin feature/AmazingFeature )

5. プルリクエストを開く

ライセンス

MITライセンスに基づいて配布されています。詳細についてはLICENSEをご覧ください。

接触

スラメット - @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