Base Network MCP 服务器

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

功能

• 9个区块链工具（其中7个无需API密钥即可使用）
• 支持 Base 主网和 Sepolia 测试网
• 实时访问区块链数据
• 支持 Docker
• 多种传输选项（标准I/O，HTTP）

快速开始

安装和构建

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

运行服务器

# 推荐用于 Claude Desktop
npm start

# 用于 HTTP 服务器
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

# 基本设置
docker run -p 3010:3010 basescan-mcp-server

# 使用 API 密钥
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              # 开发|生产
MCP_TRANSPORT_TYPE=stdio          # 标准I/O|HTTP
MCP_HTTP_PORT=3010               # HTTP 端口
BASESCAN_API_KEY=your-key        # BaseScan API 密钥（可选）
MCP_LOG_LEVEL=info               # 调试|信息|警告|错误

安全性

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

网络

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

开发

npm run dev            # 开发模式，支持热重载
npm test               # 运行测试
npm run lint           # 代码检查
npm run format         # 代码格式化

许可证

MIT