区块链数据查询服务

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

  • by u-Operating-System
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 u-Operating-System/basescan-mcp-server

使用说明

基础网络MCP服务器

用于访问基础网络区块链数据的模型上下文协议(MCP)服务器。提供在Base主网和测试网上查询区块、交易、余额和智能合约的工具。

特性

  • 9个区块链工具(7个在没有API密钥的情况下工作)
  • 基础主网和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桌面设置

增添 ~/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"
      }
    }
  }
}

码头工人

# 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 当前天然气价格 否
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

网络

  • 基础 主网:链ID 8453
  • 基础Sepolia:链ID 84532

发展

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

许可证

麻省理工学院