CryptoAPIs MCP Prepare Transactions

Servidor MCP para construir transações não assinadas em múltiplas blockchains via Crypto APIs

Documentação

@cryptoapis-io/mcp-prepare-transactions

Servidor MCP para o produto Crypto APIs Prepare Transactions. Construa transações EVM não assinadas para transferências de moedas nativas, transferências de tokens fungíveis e transferências de NFT.

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

Recursos

  • Preparar transações de transferência de moedas nativas (a partir de um endereço)
  • Preparar transações de transferência de tokens fungíveis (ERC-20)
  • Preparar transações de transferência de NFT (ERC-721)
  • Retorna o hex da transação não assinada, pronto para assinatura com @cryptoapis-io/mcp-signer

Pré-requisitos

Instalação

npm install @cryptoapis-io/mcp-prepare-transactions

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

Uso

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

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

# HTTP transport
npx @cryptoapis-io/mcp-prepare-transactions --transport http --port 3000 --api-key YOUR_API_KEY

Claude Desktop

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

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

Cursor

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

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

MCP Inspector

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

n8n

  1. Inicie o servidor no modo HTTP:
    npx @cryptoapis-io/mcp-prepare-transactions --transport http --port 3000 --api-key YOUR_API_KEY
    
  2. No seu fluxo de trabalho do n8n, adicione um nó AI Agent
  3. Em Tools, adicione um MCP Client Tool e defina a URL para http://localhost:3000/mcp

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

Ferramentas Disponíveis

prepare_transactions_evm

Prepare transações EVM não assinadas.

AçãoDescrição
prepare-transaction-from-addressPrepare uma transferência de moeda nativa a partir de um endereço
prepare-fungible-token-transferPrepare uma transferência de token ERC-20
prepare-nft-transferPrepare uma transferência de NFT ERC-721

Argumentos de CLI

ArgumentoDescriçãoPadrão
--api-keyChave de API do Crypto APIsvariável de ambiente CRYPTOAPIS_API_KEY
--transportTipo de transporte: stdio ou httpstdio
--hostHost HTTP0.0.0.0
--portPorta HTTP3000
--pathCaminho HTTP/mcp
--statelessAtivar modo HTTP sem estadofalse

Modos de Chave de API HTTP

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

  • Com --api-key: A chave é usada para todas as solicitações. Os 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 do 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-prepare-transactions --transport http --port 3000
# Clients send x-api-key header with each request

O transporte Stdio sempre exige 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

O 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