Base Network MCP Server

Base Network MCP 服务

一个用于访问 Base Network 区块链数据的模型上下文协议（MCP）服务。提供查询 Base 主网和测试网区块、交易、余额及智能合约的工具。

功能特性

• 9 个区块链工具（其中 7 个无需 API 密钥）
• 支持 Base 主网和 Sepolia 测试网
• 实时访问区块链数据
• 支持 Docker
• 多种传输方式（stdio、HTTP）

快速开始

安装和构建

git clone https://github.com/u-Operating-System/basescan-mcp-server.git
cd basescan-mcp-server
npm install
npm run build

运行服务

# For Claude Desktop (recommended)
npm start

# For HTTP server
MCP_TRANSPORT_TYPE=http npm start

可选：BaseScan API 密钥

添加免费的 BaseScan API 密钥以使用增强功能：

1. 访问 https://basescan.org/apis
2. 创建账号并获取 API 密钥
3. 添加到环境变量：BASESCAN_API_KEY=your-key

Claude Desktop 设置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "base-network": {
      "command": "node",
      "args": ["/path/to/basescan-mcp-server/build/index.js"],
      "env": {
        "BASESCAN_API_KEY": "your-key-here"
      }
    }
  }
}

Docker

# Basic setup
docker run -p 3010:3010 basescan-mcp-server

# With API key
docker run -p 3010:3010 -e BASESCAN_API_KEY=your-key basescan-mcp-server

可用工具

工具	描述	是否需要 API 密钥
get_latest_block	最新区块信息	否
get_block	按编号/哈希查询区块	否
get_transaction	交易详情	否
get_balance	ETH 余额查询	否
get_gas_price	当前 Gas 价格	否
check_contract	智能合约检测	否
get_network_stats	网络统计信息	否
get_account_transactions	账户交易历史	是
get_account_tokens	代币转账历史	是

配置

通过环境变量进行配置：

NODE_ENV=development              # development|production
MCP_TRANSPORT_TYPE=stdio          # stdio|http
MCP_HTTP_PORT=3010               # HTTP port
BASESCAN_API_KEY=your-key        # BaseScan API key (optional)
MCP_LOG_LEVEL=info               # debug|info|warning|error

安全

• 将 API 密钥存储在环境变量中
• 切勿提交包含真实值的 .env 文件
• 在生产环境中使用 HTTPS

网络

• Base 主网：链 ID 8453
• Base Sepolia：链 ID 84532

开发

npm run dev            # Development with hot reload
npm test               # Run tests
npm run lint           # Code linting
npm run format         # Code formatting

许可证

MIT