CryptoAPIs MCP Market Data

Servidor MCP para preços de ativos de criptomoedas, taxas de câmbio e metadados de mercado via Crypto APIs

Documentação

@cryptoapis-io/mcp-market-data

Servidor MCP para o produto Market Data da Crypto APIs. Liste ativos suportados, obtenha taxas de câmbio e detalhes de ativos.

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

Recursos

Liste ativos de criptomoedas e moedas fiduciárias suportados com filtros e paginação
Obtenha taxas de câmbio entre quaisquer dois ativos (por símbolo ou ID do ativo)
Obtenha detalhes do ativo por ID ou símbolo

Pré-requisitos

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

Instalação

npm install @cryptoapis-io/mcp-market-data

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

Uso

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

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

# HTTP transport (listens on 127.0.0.1; see "Exposing the server beyond localhost")
npx @cryptoapis-io/mcp-market-data --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-market-data": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-market-data"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

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

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

MCP Inspector

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

n8n

Inicie o servidor no modo HTTP:

npx @cryptoapis-io/mcp-market-data --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 no Docker: localhost dentro do contêiner não é a 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

`market_data_metadata`

Ação	Descrição
`list-supported-assets`	Liste ativos de criptomoedas e moedas fiduciárias suportados. Opcional: `limit`, `offset`, `type` (cripto/fiduciária)

`market_data_exchange_rates`

Ação	Descrição
`get-exchange-rate-by-asset-symbols`	Obtenha a taxa de câmbio entre dois ativos por símbolo (ex.: BTC para USD)
`get-exchange-rate-by-asset-ids`	Obtenha a taxa de câmbio entre dois ativos por ID do ativo

`market_data_assets`

Ação	Descrição
`get-asset-details-by-asset-id`	Obtenha detalhes do ativo por ID exclusivo do ativo
`get-asset-details-by-asset-symbol`	Obtenha detalhes do ativo por símbolo (ex.: BTC, ETH)

Argumentos de CLI

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 do cabeçalho `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. 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 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-market-data --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, portanto, apenas processos na mesma máquina podem acessá-lo. Para aceitar conexões de outras máquinas ou contêineres, faça o bind explicitamente 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-market-data --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-market-data --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: os argumentos de linha de comando ficam 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