使用说明
@cryptoapi io/mcp地址历史
MCP服务器 加密API 地址历史记录产品。查询同步地址的完整区块链地址交易历史记录。
API版本: 与加密API版本兼容 2024-12-12
特性
- 查询完整的EVM地址历史记录(以太坊、以太坊经典、BSC、Polygon、Tron)
- 查询完整的UTXO地址历史记录(比特币、比特币现金、莱特币、狗狗币、达世币、Zcash)
- 管理地址同步(激活、同步、删除、列表)
- 按时间戳范围查询
- 大型结果集的基于光标的分页
先决条件
要使用此MCP服务器,您需要:
安装
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
- 以HTTP模式启动服务器:
npx @cryptoapis-io/mcp-address-history --transport http --port 3000 --api-key YOUR_API_KEY - 在n8n工作流中,添加 AI 代理 节点
- 在...之下 工具,添加一个 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密钥模式).
-
命令行参数 (推荐):
npx @cryptoapis-io/mcp-address-history --api-key {your_api_key} -
环境变量:
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——无需安装。
许可证
麻省理工学院