区块链地址历史查询服务

提供EVM和UTXO区块链地址的完整交易历史查询及管理功能,适用于加密货币数据分析与监控场景。

  • by CryptoAPIs-io
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 CryptoAPIs-io/cryptoapis-mcp-address-history

使用说明

@cryptoapi io/mcp地址历史

MCP服务器 加密API 地址历史记录产品。查询同步地址的完整区块链地址交易历史记录。

API版本: 与加密API版本兼容 2024-12-12

特性

  • 查询完整的EVM地址历史记录(以太坊、以太坊经典、BSC、Polygon、Tron)
  • 查询完整的UTXO地址历史记录(比特币、比特币现金、莱特币、狗狗币、达世币、Zcash)
  • 管理地址同步(激活、同步、删除、列表)
  • 按时间戳范围查询
  • 大型结果集的基于光标的分页

先决条件

要使用此MCP服务器,您需要:

  1. 在加密API注册
  2. 生成API密钥 从您的仪表板

安装

npm install @cryptoapis-io/mcp-address-history

或安装所有加密API MCP服务器: npm install @cryptoapis-io/mcp

用法

# Run with API key
npx @cryptoapis-io/mcp-address-history --api-key YOUR_API_KEY

# Or use environment variable
export CRYPTOAPIS_API_KEY=YOUR_API_KEY
npx @cryptoapis-io/mcp-address-history

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上, %APPDATA%\Claude\claude_desktop_config.json 在Windows上):

{
  "mcpServers": {
    "cryptoapis-address-history": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-address-history"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

光标

添加 .cursor/mcp.json (项目)或 ~/.cursor/mcp.json (全球):

{
  "mcpServers": {
    "cryptoapis-address-history": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-address-history"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP检查员

npx @modelcontextprotocol/inspector npx @cryptoapis-io/mcp-address-history --api-key YOUR_API_KEY

n8n

  1. 以HTTP模式启动服务器:
    npx @cryptoapis-io/mcp-address-history --transport http --port 3000 --api-key YOUR_API_KEY
    
  2. 在n8n工作流中,添加 AI 代理 节点
  3. 在...之下 工具,添加一个 MCP客户端工具 并将URL设置为 http://localhost:3000/mcp

所有服务器默认为端口3000。使用 --port 在运行多个服务器时分配不同的端口。

可用工具

manage_address

管理历史数据访问的同步地址。支持所有EVM和UTXO区块链。

行动:

动作 描述
sync 同步历史数据的新地址
activate 激活以前同步的地址
delete 删除已同步的地址
list 列出所有已同步的地址

evm_address_history

查询EVM地址完整历史记录(需要同步地址)。

行动:

动作 描述
get-statistics 获取地址统计信息
list-transactions 列出所有交易
list-transactions-by-timestamp 根据时间戳列出交易
list-token-transfers 列出代币转移
list-internal-transactions 列出内部交易
list-tokens 按地址列出持有的令牌

支持的区块链: 以太坊,以太坊经典,binance智能链,多边形,tron

注: get-statistics 和 list-transactions-by-timestamp 仅支持以太坊和以太坊经典。其他操作支持所有五个区块链。

utxo_address_history

查询UTXO地址完整历史记录(需要同步地址)。

行动:

动作 描述 分页
get-statistics 获取地址统计信息 -
list-transactions 列出所有交易 游标
list-transactions-by-timestamp 从时间戳 游标列出交易
list-unspent-outputs 列出未用输出(UTXO) 偏移

支持的区块链: 比特币、比特币现金、莱特币、狗狗币、破折号、zcash

分页

大多数端点使用 基于光标的分页:

// Response
{
  "items": [...],
  "limit": 10,
  "hasMore": true,
  "nextStartingAfter": "abc123"
}

使用 nextStartingAfter 值为 startingAfter 下一个请求中的参数。

例外情况: list-unspent-outputs 用途 偏移分页:

// Response
{
  "items": [...],
  "limit": 10,
  "offset": 0,
  "total": 150
}

配置

对于 标准 传输,在启动时通过CLI参数或环境变量提供API密钥。对于 超文本传输协议 运输,也可以根据请求通过以下方式提供 x-api-key 标题(参见 HTTP API密钥模式).

  1. 命令行参数 (推荐):

    npx @cryptoapis-io/mcp-address-history --api-key {your_api_key}
    
  2. 环境变量:

    export CRYPTOAPIS_API_KEY={your_api_key}
    

CLI参数

参数 描述
--api-key 加密API API密钥
--transport 运输类型: stdio (默认)或 http
--host HTTP主机(默认值: 0.0.0.0)
--port HTTP端口(默认值: 3000)
--path HTTP路径(默认值: /mcp)
--stateless 为HTTP启用无状态模式

HTTP API密钥模式

使用HTTP传输时,服务器支持两种API密钥模式:

  • 随着 --api-key: 密钥用于所有请求。 x-api-key 请求标头被忽略。
  • 没有 --api-key: 每个请求必须包括 x-api-key 带有有效Crypto API密钥的标头。这使得可以托管一个公共服务器,每个用户都可以提供自己的密钥。
# Per-request key mode (multi-tenant)
npx @cryptoapis-io/mcp-address-history --transport http --port 3000
# Clients send x-api-key header with each request

Stdio传输在启动时总是需要一个API密钥。

重要提示:需要API密钥

警告: 在没有有效API密钥或使用不正确密钥的情况下发出请求,可能会导致您的IP被禁止进入加密API生态系统。在启动任何服务器之前,请始终确保配置了有效的API密钥。

远程MCP服务器

Crypto API提供了一个官方远程MCP服务器,其中包含通过HTTP Streamable传输提供的所有工具,网址为 https://ai.cryptoapis.io/mcp.通过 x-api-key header——无需安装。

许可证

麻省理工学院