Contract Inspector

Retrieve on-chain information for EVM contracts locally using an Ethereum RPC node and Etherscan API.

基于 MCP 协议的本地以太坊合约信息获取工具，支持在 Cursor 等 AI 工具中使用。采用uv作为现代化的 Python 项目管理工具。

重要说明：这是一个本地 MCP 服务，Cursor 会自动管理服务的启动和停止，无需用户手动启动服务器。

- 🔍 获取 EVM 合约链上信息
- 📊 调用所有无参数 view 函数
- 🌐 整合 Etherscan 和 RPC 数据
- ⚡ 并发处理，性能优化
- 📋 标准 JSON 格式输出

# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # 或使用 pip pip install uv

# 克隆/进入项目目录 cd ContractInfoMCP # 创建虚拟环境并安装所有依赖（一键搞定） uv sync

# 复制环境变量模板 cp env.example .env # 编辑 .env 文件，填入您的 API keys # 需要配置： # - RPC_URL：您的以太坊 RPC 节点地址（如 Infura、Alchemy 等） # - ETHERSCAN_API_KEY：您的 Etherscan API 密钥

配置完成后，您只需要在 Cursor 中添加 MCP 配置即可。无需手动启动任何服务器，Cursor 会自动管理本地 MCP 服务的生命周期。

在 Cursor 的 MCP 设置中添加以下配置。Cursor 会根据此配置自动启动和管理 MCP 服务。

{ "mcpServers": { "contract-inspector": { "command": "<project_path>/.venv/bin/python", "args": ["-m", "contract_inspector.main"], "cwd": "<project_path>" } } }

{ "mcpServers": { "contract-inspector": { "command": "<project_path>/.venv/Scripts/python.exe", "args": ["-m", "contract_inspector.main"], "cwd": "<project_path>" } } }

# 在项目目录中运行 pwd # macOS/Linux echo %cd% # Windows CMD echo $PWD # Windows PowerShell

- macOS/Linux：/Users/username/Projects/ContractInfoMCP
- Windows：C:\\Users\\username\\Projects\\ContractInfoMCP

配置完成后，当您在 Cursor 中首次使用 MCP 工具时，Cursor 会自动启动本地服务。您可以直接在 Cursor 聊天中输入：

查询 0xdac17f958d2ee523a2206206994597c13d831ec7 地址的基本信息

- 功能：获取合约完整信息，调用所有不需要参数的 view 函数
- 参数：contract_address(合约地址)
- 输出：JSON 格式的合约信息和函数调用结果

- 功能：获取合约基本摘要，不调用函数
- 参数：contract_address(合约地址)
- 输出：合约基本信息

contract_inspector/ ├── main.py # MCP 服务器入口 ├── contract_analyzer.py # 核心分析逻辑 ├── etherscan_client.py # Etherscan API ├── web3_client.py # Web3 RPC 客户端 ├── config.py # 配置管理 └── utils.py # 工具函数

- 安装 uv：pip install uv
- 或访问：https://github.com/astral-sh/uv

# 确保在项目目录中 cd <project_path> # 以可编辑模式重新安装包 uv pip install -e . # 验证模块可以正确导入 .venv/bin/python -c "import contract_inspector; print('模块导入成功')" # 获取正确的项目路径 pwd # 将输出的路径用于Cursor配置

MCP server for Klever blockchain smart contract development, on-chain data exploration, and VM interaction. Public remote server available at https://mcp.klever.org/mcp.

Read/write to over 2k blockchains, enabling data querying, contract analysis/deployment, and transaction execution, powered by Thirdweb.

An MCP server providing onchain tools for AI applications to interact with the Base Network and Coinbase API.

Interact with the CW-Social smart contract on Cosmos-based blockchains.

A comprehensive toolkit for Ethereum blockchain analysis directly within Claude AI.

An MCP server that provides complete access to Ethereum Virtual Machine (EVM) JSON-RPC methods. Works with any EVM-compatible node provider including Infura, Alchemy, QuickNode, local nodes, and more.

Provides blockchain services for over 30 EVM-compatible networks through a unified interface.

A lightweight MCP server for Solidity development using the Foundry toolchain (Forge, Cast, and Anvil).

About MCP server for TRON blockchain — connect AI agents to TRX, TRC20, smart contracts, staking & governance via GoTRON SDK

Provides onchain tools for AI applications to interact with the Hashkey Network.