Blockchain Mcp Powered By Tatum

由 Tatum 驱动的 Blockchain MCP

这是一个 Model Context Protocol（MCP）服务，可提供 Tatum Blockchain Data API 和 RPC Gateway，让大模型客户端能够查询 130 多个网络上的区块链数据。可在 Tatum MCP 页面或仪表板获取 API 密钥。

功能

• 130 多个区块链网络：Bitcoin、Ethereum、Solana、Polygon、Arbitrum、Base、Avalanche 等。
• 🔗 Blockchain Data API：区块、交易、余额、网络信息等。
• 🌐 RPC Gateway：直接访问区块链 RPC 端点。

需要 Node.js 18+ 和 TATUM_API_KEY。

安装

npm install -g @tatumio/blockchain-mcp

也可以不进行全局安装：

npx @tatumio/blockchain-mcp

已发布的二进制文件：blockchain-mcp 和 blockchain-mcp-server（入口相同）。

MCP 客户端配置

1. 在 dashboard.tatum.io 创建免费的 API 密钥。
2. 将服务添加到 MCP 客户端（Cursor、Claude Desktop、VS Code 等）：

{
  "mcpServers": {
    "tatumio": {
      "command": "npx",
      "args": ["@tatumio/blockchain-mcp"],
      "env": {
        "TATUM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

请勿提交 API 密钥。仅在客户端配置中使用环境变量。

提示词示例

连接后，你可以让助手使用 MCP 工具，例如：

• “BTC/USD 汇率是多少？” → 使用 get_exchange_rate，参数为 symbol: BTC、basePair: USD
• “显示 Vitalik 的原生 ETH 余额历史记录” → 在 ethereum-mainnet 上使用 get_wallet_portfolio / get_transaction_history
• “最新的 Ethereum 区块编号是多少？” → 使用 gateway_execute_rpc，参数为 eth_blockNumber

链标识符使用 Tatum 网关名称（例如 ethereum-mainnet、bitcoin-mainnet）。调用 gateway_get_supported_chains 获取实时列表。

可用工具（13 个）

Blockchain Data（10 个）

工具	描述
get_metadata	根据合约地址和代币 ID 获取 NFT/多代币元数据
get_wallet_balance_by_time	指定区块或时间戳时的原生钱包余额
get_wallet_portfolio	钱包资产组合（原生代币、同质化代币、NFT）
get_owners	NFT 或代币合约的所有者
check_owner	检查某个地址是否持有指定代币
get_transaction_history	一个或多个地址的交易历史记录
get_block_by_time	指定时间戳的区块信息
get_tokens	代币元数据（合约地址或 native）
check_malicious_address	检查钱包/合约地址的安全性
get_exchange_rate	法币/加密货币汇率（例如 BTC / USD）

RPC Gateway（3 个）

工具	描述
gateway_get_supported_chains	网关支持的所有网络
gateway_get_supported_methods	某条链支持的 RPC/REST 方法
gateway_execute_rpc	在某条链上运行 JSON-RPC 方法或 REST 调用

支持的网络

Tatum 支持许多 EVM 和非 EVM 链。例如：

• EVM：Ethereum（主网、Sepolia、Holesky）、Polygon、Arbitrum、Optimism、Base、BSC、Avalanche、Fantom、Celo、Gnosis、Ronin 等。
• 非 EVM：Bitcoin、Litecoin、Dogecoin、Solana、Cardano、Tezos、Stellar、Ripple 等。

如需获取权威的链 ID 和 RPC 覆盖范围，请使用 gateway_get_supported_chains 或参阅支持的区块链。

开发

git clone https://github.com/tatumio/blockchain-mcp.git
cd blockchain-mcp
npm install
cp .env.example .env   # add your TATUM_API_KEY
npm run build

在本地运行 MCP 服务：

export TATUM_API_KEY=your-key
npm start
# or via CLI wrapper:
npx blockchain-mcp --api-key your-key

将本地 MCP 客户端指向已构建的 CLI：

{
  "mcpServers": {
    "tatumio-local": {
      "command": "node",
      "args": ["/absolute/path/to/blockchain-mcp/dist/cli.js"],
      "env": { "TATUM_API_KEY": "YOUR_API_KEY" }
    }
  }
}

对实时 API 进行冒烟测试（需要 TATUM_API_KEY）：

npm run verify:tools

文档

• Tatum API 文档
• API 参考
• 模型上下文协议
• 代码仓库

许可证

MIT — 参见 LICENSE。

关于 Tatum

Tatum 为开发者提供区块链 API、SDK 和基础设施。