Blockchain Address Scanner

MCP区块链扫描器

用于鲸鱼检测和区块链分析的多链MCP服务器。使用 克劳德代码, 克劳德桌面版, GPT法典，以及任何兼容MCP的客户端。

支撑链

扩展就绪

该架构支持添加任何EVM链。这些是预先配置的，但在中被注释掉了 src/core/chains.py:

要启用，请取消注释中的链配置 chains.py 并将API密钥添加到 .env.

快速开始

# 1. Setup
make setup
cp .env.example .env
# Edit .env with your API keys

# 2. Configure MCP client
make config-claude   # For Claude Desktop
make config-codex    # For GPT Codex

# 3. Restart your MCP client

可用工具

所有工具都接受 chain 参数： ethereum （默认）或 bsc.

例子

Check balance on Ethereum: 0xbe0eb53f46cd790cd13851d5eff43d12404d33e8

Analyze whale on BSC: 0xf977814e90da44bfa03b6295a0616a897441acec

Track whale movements above 1000 BNB on BSC

Compare whales: 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae, 0xbe0eb53f46cd790cd13851d5eff43d12404d33e8

鲸鱼分类

建筑

┌─────────────────────────────────────────────────────┐
│           MCP Server (FastMCP) - 13 Tools           │
└──────────────────────┬──────────────────────────────┘
                       │
        ┌──────────────┴──────────────┐
        │                             │
   BlockchainService            WhaleDetector
   (multi-chain API)            (analysis engine)
        │                             │
        │  async httpx (timeout=30s)  │  classify, score,
        │  rate-limited (5 req/s)     │  discover, track
        │                             │
        └──────────────┬──────────────┘
                       │
             Etherscan V2 API
             (chainid routing)

src/core/
├── server.py             # MCP tool definitions (13 tools)
├── blockchain_service.py # Multi-chain API client
├── whale_detector.py     # Whale analysis engine
├── chains.py             # Chain registry + known addresses
├── validators.py         # Input validation
└── __init__.py           # Public API exports

添加新链

编辑 src/core/chains.py 并添加到 CHAIN_REGISTRY:

CHAIN_REGISTRY["polygon"] = ChainConfig(
    name="Polygon",
    symbol="MATIC",
    api_url="https://api.polygonscan.com/api",
    api_key_env="POLYGONSCAN_API_KEY",
    explorer_url="https://polygonscan.com",
    chain_id=137,
)

使用Etherscan V2 API的链(api.etherscan.io/v2/api)共享相同的API密钥，并使用 chainid 参数。具有自己的API（Polygonscan、Arbiscan、Basescan）的链需要单独的API密钥。

可选择添加已知的whale并交换地址 KNOWN_WHALES 和 EXCHANGE_ADDRESSES 对新链进行更丰富的分析。

发出命令

make setup        # Create venv, install deps
make run          # Start MCP server
make test         # Run pytest suite
make lint         # Check code style (ruff)
make format       # Auto-format + fix
make check        # Verify config
make clean        # Remove venv
make config-claude # Show Claude Desktop config
make config-codex  # Show Codex config

配置

# .env
ETHERSCAN_API_KEY=your_key    # from etherscan.io/myapikey
RATE_LIMIT=5                  # requests/sec (optional, default: 5)

获取免费的API密钥：https://etherscan.io/myapikey

需求

• Python 3.10+
• Etherscan API密钥（免费层：仅限以太坊）
• MCP兼容客户端（克劳德桌面、克劳德代码、GPT Codex等）

故障排除

许可证

麻省理工学院