モナドMCPサーバー

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

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

特徴	説明	コマンド例
残高を取得する	Monad テストネットアドレスの MON 残高を確認します。	`check MON 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
トークン残高を取得する	アドレスの特定の ERC-20 トークンの残高を確認します。	`check token balance for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contract 0x1234...5678`
取引の詳細を取得する	ハッシュによってトランザクションの詳細情報を取得します。	`get details for transaction 0xabcdef1234567890...`
ガソリン価格	Monad テストネットの現在のガス価格を取得します。	`what is the current gas price`
最新ブロックを取得	Monad テストネット上の最新ブロックに関する情報を取得します。	`show latest block info`
複数の残高を取得する	アドレスの複数のトークンの残高を確認します。	`check multiple balances for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contracts 0x1234...5678, 0x5678...1234`
送信モン	MON トークンを Monad テストネット上の指定されたアドレスに送信します。	`send 0.1 MON to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765`
トークン送信	トークンコントラクトから指定されたアドレスに ERC-20 トークンを送信します。	`send 100 USDT to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765 from contract 0x1234...5678`
コイントスをプレイする	表か裏かに MON を賭けてコインフリップゲームをプレイします (最小賭け金: 0.01 MON)。	`flip 0.1 mon head`
コイントスの履歴を取得する	勝ち、負け、利益など、アドレスのコインフリップゲームの履歴を表示します。	`history flip`または`history flip 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
ステークエプロン	Apriori ステーキングプラットフォームで MON トークンをステーキングします。	MONトークンをステークするには、 `stake 0.1 mon` 。
アンステーク・アプルモン	Apriori プラットフォームからすべての MON トークンをアンステークします。	`unstake aprmon`実行すると、ステーク済みのMONトークンがすべてアンステークされます。リクエストIDは後で請求時に使用するので、メモしておいてください。
クレーム・エプロン	保留中の未ステークの MON トークンを請求します。	アンステーキングから10分経過したら、 `claim aprmon requestID`を使用します。requestID `requestID` 、アンステーキング中に取得したIDに置き換えてください。
スワップ	Monad Testnet ネットワークに統合された Uniswap V2 スワップ機能	上場トークンの場合： `swap 0.1 MON to USDT` 。非上場トークンの場合： `swap 0.1 MON to 0xxxxxxxxxxx` （コントラクトアドレスを使用）。

クイックスタート

# Clone the repository
git clone https://github.com/Semutireng22/mcp-monad.git
cd mcp-monad

# Install dependencies
npm install

# Create .env file (replace with your private key)
echo "PRIVATE_KEY=0xyourprivatekeyhere" > .env

# Build and run
npm run build
node build/index.js

前提条件

Node.js (v16以降)
npmまたはyarn
Claude Desktop（MCP クライアント統合用）
トランザクションとガス料金に十分なMONを備えたMonadテストネットウォレット（play-coinflip、send-mon、send-tokenに必要）
Monadテストネットウォレット用の有効なPRIVATE_KEYを含む.envファイル

設定と使用方法

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"
  ]
});

環境の設定

プロジェクトのルートディレクトリ (例: /path/to/mcp-monad/.env ) に次の内容の.envファイルを作成します。

PRIVATE_KEY=0xyourprivatekeyhere

0xyourprivatekeyhere Monad テストネットウォレットの秘密鍵 ( 0xで始まる 64 桁の 16 進文字) に置き換えます。

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

echo .env >> .gitignore

サーバーの構築と実行

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

npm run build

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

node build/index.js

Claude Desktopとの統合

Claude Desktop を開きます。
Settings > Developerに移動します。
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 ) に置き換えます。

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

貢献

プロジェクトをフォークする
Feature ブランチを作成します ( git checkout -b feature/AmazingFeature )
変更をコミットします（ git commit -m 'Add some AmazingFeature' ）
ブランチにプッシュする ( git push origin feature/AmazingFeature )
プルリクエストを開く

ライセンス

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

Monad MCP Server

Integrations