Monad Custom Agent (MCP Server for Cursor)

Monad 自定义 Agent（Cursor 的 MCP 服务）

Monad MCP Madness - Mission 2 投稿

概述

本项目实现了一个自定义模型上下文协议（MCP）服务，旨在与 Cursor 和 Claude Desktop 等 AI 驱动的 IDE 无缝协作。用户可以在 IDE 中使用自然语言提示词与 Monad Testnet 交互。

该 Agent 利用各种工具和 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：调用指定合约上的任意只读函数。若用户未提供 ABI，则自动从 Thirdweb Insight 获取（需要 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