mcp-address-latest

@cryptoapis-io/mcp-address-latest

用于 Crypto APIs Address Latest 产品的 MCP 服务。查询最近的区块链地址数据（最近 14 天），无需同步地址。

**API 版本：**兼容 Crypto APIs 版本 2024-12-12

功能

• 查询 EVM 地址（Ethereum、Ethereum Classic、BSC、Polygon、Avalanche（C-Chain）、Arbitrum、Base、Optimism、Tron）
• 查询 UTXO 地址（Bitcoin、Bitcoin Cash、Litecoin、Dogecoin、Dash、Zcash）
• 查询 Solana 地址（SOL 余额、交易、SPL 代币）
• 查询 XRP/Ripple 地址（余额、交易、序列号）
• 查询 Kaspa 地址（余额、交易）
• 使用基于游标的分页处理大型结果集
• 无需同步地址（与 Address History 不同）

前提条件

要使用此 MCP 服务，你需要：

1. 在 Crypto APIs 注册
2. 从控制面板生成 API 密钥

安装

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

或安装所有 Crypto APIs MCP 服务：npm install @cryptoapis-io/mcp

用法

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

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

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

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

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

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

MCP Inspector

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

n8n

1. 以 HTTP 模式启动服务：

   npx @cryptoapis-io/mcp-address-latest --transport http --port 3000 --api-key YOUR_API_KEY
   

2. 在 n8n 工作流中，添加一个 AI Agent 节点
3. 在 Tools 下添加一个 MCP Client Tool，并将 URL 设为 http://localhost:3000/mcp

**在 Docker 中运行 n8n：**容器内的 localhost 并不是你的机器。使用 --host 0.0.0.0 和 MCP_AUTH_TOKEN 启动服务（参见将服务暴露到 localhost 之外），将 URL 设为 http://host.docker.internal:3000/mcp，并在 MCP Client Tool 凭据中添加 Authorization: Bearer <token> 标头。

所有服务的默认端口均为 3000。运行多个服务时，使用 --port 指定不同端口。

可用工具

evm_address_latest

查询最新的 EVM 地址数据。

操作：

操作	描述
get-balance	获取地址余额
get-next-nonce	获取下一个可用的 nonce。支持：Ethereum（mainnet、sepolia）、Ethereum Classic（mainnet、mordor）、BSC（mainnet、testnet）
list-transactions	列出地址交易
list-token-transfers	列出代币转账（ERC-20、ERC-721、ERC-1155）
list-internal-transactions	列出内部交易

**支持的区块链：**ethereum、ethereum-classic、binance-smart-chain、polygon、avalanche（C-Chain）、arbitrum、base、optimism、tron

utxo_address_latest

查询最新的 UTXO 地址数据。

操作：

操作	描述
get-balance	获取地址余额
list-transactions	列出地址交易
list-unconfirmed-transactions	列出未确认交易（内存池）；使用偏移量分页

**支持的区块链：**bitcoin、bitcoin-cash、litecoin、dogecoin、dash、zcash

solana_address_latest

查询最新的 Solana 地址数据。

操作：

操作	描述
get-balance	获取地址的 SOL 余额
list-transactions	列出地址交易
list-tokens	列出地址持有的 SPL 代币

**支持的网络：**mainnet、devnet

xrp_address_latest

查询最新的 XRP（Ripple）地址数据。

操作：

操作	描述
get-balance	获取地址的 XRP 余额
list-transactions	列出地址交易
get-next-sequence	获取下一个可用的序列号

**支持的网络：**mainnet、testnet

kaspa_address_latest

查询最新的 Kaspa 地址数据。

操作：

操作	说明
get-balance	获取地址的 KAS 余额
list-transactions	列出地址交易

支持的网络： mainnet

分页

大多数列表端点使用基于游标的分页：

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

在下一个请求中，将 nextStartingAfter 的值用作 startingAfter 参数。

例外： list-unconfirmed-transactions（UTXO）使用偏移量分页，包含 limit、offset 和 total 字段。

配置

对于 stdio 传输，可在启动时通过 CLI 参数或环境变量提供 API 密钥。对于 HTTP 传输，也可通过每个请求的 x-api-key 标头提供（参见 HTTP API 密钥模式）。

1. 命令行参数（推荐）：

   npx @cryptoapis-io/mcp-address-latest --api-key {your_api_key}
   

2. 环境变量：

   export CRYPTOAPIS_API_KEY={your_api_key}
   

CLI 参数

参数	说明
--api-key	Crypto APIs API 密钥
--transport	传输类型：stdio（默认）或 http
--host	HTTP 主机（默认：127.0.0.1；使用 0.0.0.0 接受远程连接——需要通过 --api-key 提供身份验证令牌）
--auth-token	调用方必须发送的 Bearer 令牌（Authorization: Bearer <token>）；建议使用 MCP_AUTH_TOKEN 环境变量
--allowed-hosts	非回环绑定的逗号分隔 Host 标头允许列表
--port	HTTP 端口（默认：3000）
--path	HTTP 路径（默认：/mcp）
--stateless	为 HTTP 启用无状态模式

HTTP API 密钥模式

使用 HTTP 传输时，服务支持两种 API 密钥模式：

• 使用 --api-key： 所有请求都会使用此密钥。请求中的 x-api-key 标头会被忽略。
• 不使用 --api-key： 每个请求都必须包含带有有效 Crypto APIs 密钥的 x-api-key 标头。这样便可托管公共服务，由每位用户提供自己的密钥。

# Per-request key mode (multi-tenant)
npx @cryptoapis-io/mcp-address-latest --transport http --port 3000
# Clients send x-api-key header with each request

将服务暴露到 localhost 之外

HTTP 模式默认监听 127.0.0.1，因此只有同一台机器上的进程可以访问。 若要接受来自其他机器或容器的连接，请显式绑定并保护端口：

# Startup-key mode: callers must present the token (the server refuses to start without one)
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
npx @cryptoapis-io/mcp-address-latest --transport http --host 0.0.0.0 --port 3000 --api-key YOUR_API_KEY \
  --allowed-hosts mcp.internal.example
# Clients send: Authorization: Bearer $MCP_AUTH_TOKEN

# Per-request key mode: no startup key, every request must carry the caller's own x-api-key
npx @cryptoapis-io/mcp-address-latest --transport http --host 0.0.0.0 --port 3000

未绑定到回环地址时，--allowed-hosts 会限制 Host 标头（防止 DNS 重绑定）。建议使用 MCP_AUTH_TOKEN，而非 --auth-token：命令行参数会显示在进程列表中。

Stdio 传输始终需要在启动时提供 API 密钥。

重要：需要 API 密钥

警告： 使用无效 API 密钥或不提供有效 API 密钥发起请求，可能导致你的 IP 被 Crypto APIs 生态系统封禁。启动任何服务前，请务必确保已配置有效的 API 密钥。

远程 MCP 服务

Crypto APIs 提供官方远程 MCP 服务，可通过 HTTP Streamable 传输使用所有工具，地址为 https://ai.cryptoapis.io/mcp。通过 x-api-key 标头传递 API 密钥——无需安装。

许可证

MIT