Crypto Apis Blockchain Utils

@cryptoapis-io/mcp-utils

适用于 Crypto APIs Utils 产品的 MCP 服务。验证地址、解码原始交易，以及对 XRP X-Address 进行编码和解码。

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

功能

• UTXO 工具： 验证地址、解码原始交易十六进制数据（bitcoin、bitcoin-cash、litecoin、dogecoin、dash、zcash）
• EVM 工具： 验证地址、解码原始交易十六进制数据
• XRP 工具： 验证地址、解码 X-Address、编码 X-Address
• 派生地址： 无需同步即可派生 HD 钱包（xPub/yPub/zPub）的找零地址或收款地址

前提条件

1. 在 Crypto APIs 注册
2. 生成 API 密钥

安装

npm install @cryptoapis-io/mcp-utils

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

用法

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

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

# HTTP transport (listens on 127.0.0.1; see "Exposing the server beyond localhost")
npx @cryptoapis-io/mcp-utils --transport http --port 3000 --api-key YOUR_API_KEY

Claude Desktop

添加到 Claude Desktop 配置（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

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

Cursor

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

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

MCP Inspector

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

n8n

1. 以 HTTP 模式启动服务：

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

2. 在 n8n 工作流中添加一个 AI Agent 节点
3. 在 工具 下添加一个 MCP 客户端工具，并将 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 客户端工具凭据中添加 Authorization: Bearer <token> 标头。

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

可用工具

utxo_utils

操作	说明
validate-address	检查 UTXO 地址是否有效。需要 blockchain、network、address
decode-raw-transaction	解码原始交易十六进制数据。需要 blockchain、network、rawTransactionHex
convert-bitcoin-cash-address	在 legacy 和 CashAddr 格式之间转换 Bitcoin Cash 地址。需要 network、address（仅适用于 Bitcoin Cash，无需 blockchain 参数）

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

evm_utils

操作	说明
validate-address	检查 EVM 地址是否有效。需要 blockchain、network、address
decode-raw-transaction	解码原始交易十六进制数据。需要 blockchain、network、rawTransactionHex

xrp_utils

操作	说明
validate-address	检查 XRP 地址是否有效。需要 network、address
decode-x-address	将 X-Address 解码为经典地址和标签。需要 network、xAddress
encode-x-address	将经典地址和标签编码为 X-Address。需要 network、classicAddress、addressTag

derive_addresses

无需同步即可派生 HD 钱包（xPub/yPub/zPub）的找零地址或收款地址。每次调用最多派生 10 个地址。

参数	说明
blockchain	目标区块链
network	网络名称
extendedPublicKey	HD 钱包的 xPub/yPub/zPub
addressFormat	地址格式（可选）：p2pkh、p2sh、p2wpkh、standard、p2sh-cash、p2pkh-cash、classic、base58
addressesCount	要派生的地址数量，最多为 10（可选）
isChange	若为 true，则派生找零地址；若为 false，则派生收款/存款地址（可选，仅适用于 UTXO）
startIndex	派生起始索引（可选）

支持的区块链： bitcoin、bitcoin-cash、litecoin、dogecoin、dash、zcash、ethereum、ethereum-classic、binance-smart-chain、xrp、tron

CLI 参数

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

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-utils --transport http --port 3000
# Clients send x-api-key header with each request

将服务开放给本地主机以外的网络

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-utils --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-utils --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