Monad Custom Agent (MCP Server for Cursor)

Monad Custom Agent（Cursor 用 MCP サーバー）

Monad MCP Madness - Mission 2 への提出作品

概要

このプロジェクトは、Cursor や Claude Desktop などの AI 搭載 IDE とシームレスに連携するよう設計された、カスタム Model Context Protocol（MCP）サーバーを実装しています。ユーザーは IDE 内で自然言語のプロンプトを使用して、Monad Testnet を操作できます。

このエージェントは、さまざまなツールや API を活用し、Monad エコシステムに関する包括的な情報を提供します。

• ブロックチェーンとの直接的なやり取り： web3.py を使用して Monad Testnet RPC に問い合わせ、残高、トランザクション、ブロックなどの基本データを取得します。
• Zerion 経由のインデックスデータ： Zerion API を利用して、ERC20 残高を効率的に取得し、トランザクション履歴を分析（コントラクトとのやり取り回数に使用）するとともに、ユーザーの NFT トランザクション履歴を取得します。
• Magic Eden 経由のマーケットプレイスデータ： Magic Eden API を統合し、ユーザーが保有する NFT コレクションの詳細な統計、特定の NFT のアクティビティ履歴、Monad Testnet のトレンドコレクションを提供します。
• Thirdweb 経由のコントラクトメタデータ： Thirdweb Insight API を使用して、検証済みコントラクトの ABI を自動取得し、コントラクトとのやり取りを簡素化します。

このプロジェクトは、AI ツール（Cursor／Claude と、ツールブリッジとして機能する MCP サーバー自体）を使用し、IDE 内で動作し、Monad Testnet とやり取りし、有用な出力を生成し、ツールセットを通じて複雑な操作を実行できる能力を実証することで、ミッションの要件を満たしています。

機能／実装済みツール

MCP サーバーは、Cursor／Claude で自然言語のプロンプトを通じて利用できる、以下のカスタムツールを公開します。

• get_native_monad_balance_tool：Monad アドレスのネイティブ MON 残高を取得します。
• get_monad_erc20_balances_tool：アドレスが保有する ERC20 トークンを、名前とシンボルを含めて一覧表示します（Zerion Positions API を使用）。
• get_monad_transaction_tool：特定のトランザクションハッシュの詳細情報を取得します（Web3.py を使用）。
• get_monad_block_tool：特定のブロック番号、または「latest」のような識別子を指定して、ブロックの詳細情報を取得します（Web3.py を使用）。
• read_contract_tool：指定したコントラクトの読み取り専用関数を呼び出します。ユーザーが指定していない場合は、Thirdweb Insight から ABI を自動取得します（THIRDWEB_CLIENT_ID が必要です）。
• get_contract_interactions_tool：最近のトランザクション履歴（Zerion Transactions API 経由）を分析し、アドレスがやり取りした（トランザクションを送信した）一意のスマートコントラクトの数を数えます。ZERION_API_KEY が必要です。
• get_nft_collection_stats_tool：Monad Testnet 上でウォレットが保有するすべての NFT コレクションについて、詳細な統計（フロア価格、トップビッド、取引高、ユーザー数など）を取得します（Magic Eden Collections API を使用）。MAGIC_EDEN_API_KEY が必要です。
• get_nft_activity_tool：Monad Testnet 上の特定の NFT の詳細なアクティビティ履歴（転送、出品、販売、入札）を取得します（Magic Eden Token Activity API を使用）。MAGIC_EDEN_API_KEY が必要です。
• get_trending_collections_tool：指定期間の販売数または取引高に基づいて、Monad Testnet で現在トレンドになっている NFT コレクションのリストを取得します（Magic Eden Trending API を使用）。MAGIC_EDEN_API_KEY が必要です。
• get_user_nft_transactions_tool：特定のユーザーアドレスに関する NFT 関連トランザクション（NFT のミント、転送、販売）の全般的なフィードを取得します（NFT フィルター付きの Zerion Transactions API を使用）。ZERION_API_KEY が必要です。
• get_contract_abi_tool：Thirdweb Insight から検証済みコントラクトの ABI を直接取得して返します。THIRDWEB_CLIENT_ID が必要です。

技術スタック

• Python 3.11+
• MCP サーバーフレームワーク（mcp ライブラリ／FastMCP）
• Web3.py（Monad RPC との直接的なやり取り用）
• Zerion API（インデックス化された残高、トランザクション、やり取り用）
• Magic Eden API（NFT の統計、アクティビティ、トレンド用）
• Thirdweb Insight API（ABI 取得用）
• python-dotenv（環境変数の管理用）
• httpx（非同期 API 呼び出し用）
• click（サーバーの CLI オプション用）
• Cursor／Claude Desktop（MCP クライアント／インターフェースとして）

Links

• Demo Video: [https://x.com/eccentrichealer/status/1917301085548515488]
• Setup Instructions: See SETUP.md