CryptoAPIs MCP HD Wallet

Servidor MCP para gerenciamento de carteiras HD, recuperação de saldo e sincronização em blockchains EVM, UTXO e XRP via Crypto APIs

GitHub

Experimente este MCPPatrocinado

Documentação

@cryptoapis-io/mcp-hd-wallet

Servidor MCP para o produto HD Wallet (Wallet as a Service) da Crypto APIs. Monitore e gerencie carteiras HD por sua chave pública estendida (xPub/yPub/zPub) — nenhuma chave privada sai do seu dispositivo.

Versão da API: Compatível com a versão 2024-12-12 da Crypto APIs

Como Funciona

Carteiras HD (Hierárquicas Determinísticas) derivam todos os endereços de uma única chave pública estendida (xPub). Você sincroniza seu xPub com a Crypto APIs, e o serviço monitora todos os endereços derivados, saldos e transações em seu nome.

Sincronize seu xPub — forneça sua chave pública estendida (xPub, yPub ou zPub) para começar o monitoramento
Derive endereços — gere novos endereços de recebimento e troco a partir do xPub
Consulte dados da carteira — obtenha saldos, liste transações, liste UTXOs e visualize ativos em todos os endereços derivados
Prepare transações — construa transações não assinadas prontas para assinatura local com @cryptoapis-io/mcp-signer

Suas chaves privadas nunca são enviadas ou armazenadas pela Crypto APIs. Apenas a chave pública estendida é usada para derivação de endereços e monitoramento de saldos.

Recursos

Sincronize carteiras por chave pública estendida (xPub/yPub/zPub)
Derive endereços de recebimento e troco a partir do xPub
Consulte saldos agregados, transações e ativos em todos os endereços derivados
Liste UTXOs para carteiras baseadas em UTXO
Prepare transações não assinadas diretamente da carteira
Suporta EVM (Ethereum, Ethereum Classic, BSC, Polygon, Avalanche (C-Chain), Arbitrum, Base, Optimism, Tron), UTXO (Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, Zcash) e XRP

Pré-requisitos

Node.js 18+
Conta e chave de API da Crypto APIs (cadastre-se | obtenha chave de API)

Instalação

npm install @cryptoapis-io/mcp-hd-wallet

Ou instale todos os servidores MCP da Crypto APIs: npm install @cryptoapis-io/mcp

Uso

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

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

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

Claude Desktop

Adicione à configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

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

Cursor

Adicione a .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

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

MCP Inspector

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

n8n

Inicie o servidor em modo HTTP:

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

No seu fluxo de trabalho do n8n, adicione um nó AI Agent
Em Tools, adicione um MCP Client Tool e defina a URL para http://localhost:3000/mcp

n8n em Docker: localhost dentro do contêiner não é sua máquina. Inicie o servidor com --host 0.0.0.0 e MCP_AUTH_TOKEN definidos (veja Expondo o servidor além do localhost), use http://host.docker.internal:3000/mcp como URL e adicione um cabeçalho Authorization: Bearer <token> à credencial do MCP Client Tool.

Todos os servidores usam a porta 3000 por padrão. Use --port para atribuir portas diferentes ao executar vários servidores.

Ferramentas Disponíveis

`manage_hd_wallet`

Gerencie carteiras HD (sincronizar, ativar, excluir, listar, status).

Ação	Descrição
`sync-wallet`	Sincronize uma carteira HD por chave pública estendida (xPub/yPub/zPub)
`list-wallets`	Liste todas as carteiras HD sincronizadas
`activate-wallet`	Ative uma carteira previamente sincronizada
`delete-wallet`	Exclua uma carteira sincronizada
`get-status`	Obtenha o status de sincronização de uma carteira

`hd_wallet_data_utxo`

Consulte dados de carteiras HD UTXO (Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, Zcash).

Ação	Descrição
`get-details`	Obtenha saldo e detalhes da carteira
`derive-receiving-address`	Derive o próximo endereço de recebimento
`derive-change-address`	Derive o próximo endereço de troco
`list-addresses`	Liste todos os endereços derivados
`list-transactions`	Liste transações da carteira
`list-utxos`	Liste saídas de transações não gastas
`list-assets`	Liste ativos mantidos pela carteira
`prepare-transaction`	Prepare uma transação não assinada a partir da carteira

`hd_wallet_data_evm`

Consulte dados de carteiras HD EVM (Ethereum, Ethereum Classic, BSC, Polygon, Avalanche (C-Chain), Arbitrum, Base, Optimism, Tron).

Ação	Descrição
`get-details`	Obtenha saldo e detalhes da carteira
`derive-receiving-address`	Derive o próximo endereço de recebimento
`list-addresses`	Liste todos os endereços derivados
`list-transactions`	Liste transações da carteira
`list-assets`	Liste tokens mantidos pela carteira
`prepare-transaction`	Prepare uma transação não assinada a partir da carteira

`hd_wallet_data_xrp`

Consulte dados de carteiras HD XRP.

Ação	Descrição
`get-details`	Obtenha saldo e detalhes da carteira
`derive-receiving-address`	Derive o próximo endereço de recebimento
`list-addresses`	Liste todos os endereços derivados
`list-transactions`	Liste transações da carteira
`list-assets`	Liste ativos mantidos pela carteira

Argumentos de Linha de Comando

Argumento	Descrição	Padrão
`--api-key`	Chave de API da Crypto APIs	variável de ambiente `CRYPTOAPIS_API_KEY`
`--transport`	Tipo de transporte: `stdio` ou `http`	`stdio`
`--host`	Host HTTP (use `0.0.0.0` para aceitar conexões remotas — requer um token de autenticação com `--api-key`)	`127.0.0.1`
`--auth-token`	Token Bearer que os chamadores devem enviar (`Authorization: Bearer <token>`); prefira a variável de ambiente `MCP_AUTH_TOKEN`	variável de ambiente `MCP_AUTH_TOKEN`
`--allowed-hosts`	Lista de permissões de cabeçalhos `Host` separada por vírgulas para binds não-loopback	—
`--port`	Porta HTTP	`3000`
`--path`	Caminho HTTP	`/mcp`
`--stateless`	Ativar modo HTTP sem estado	`false`

Modos de Chave de API HTTP

Ao usar transporte HTTP, o servidor suporta dois modos de chave de API:

Com --api-key: A chave é usada para todas as solicitações. Cabeçalhos de solicitação x-api-key são ignorados.
Sem --api-key: Cada solicitação deve incluir um cabeçalho x-api-key com uma chave válida da Crypto APIs. Isso permite hospedar um servidor público onde cada usuário fornece sua própria chave.

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

Expondo o servidor além do localhost

O modo HTTP escuta em 127.0.0.1 por padrão, então apenas processos na mesma máquina podem acessá-lo. Para aceitar conexões de outras máquinas ou contêineres, faça bind explícito e proteja a porta:

# 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-hd-wallet --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-hd-wallet --transport http --host 0.0.0.0 --port 3000

--allowed-hosts restringe o cabeçalho Host (proteção contra rebinding de DNS) quando não está vinculado ao loopback. Prefira MCP_AUTH_TOKEN em vez de --auth-token: argumentos de linha de comando são visíveis na lista de processos.

O transporte Stdio sempre requer uma chave de API na inicialização.

Importante: Chave de API Necessária

Aviso: Fazer solicitações sem uma chave de API válida — ou com uma incorreta — pode resultar no banimento do seu IP do ecossistema Crypto APIs. Sempre garanta que uma chave de API válida esteja configurada antes de iniciar qualquer servidor.

Servidor MCP Remoto

A Crypto APIs fornece um servidor MCP remoto oficial com todas as ferramentas disponíveis via transporte HTTP Streamable em https://ai.cryptoapis.io/mcp. Envie sua chave de API pelo cabeçalho x-api-key — sem necessidade de instalação.

Licença

MIT