CryptoAPIs MCP Market Data

Servidor MCP para precios de activ

Documentación

@cryptoapis-io/mcp-market-data

Servidor MCP para el producto Market Data de Crypto APIs. Lista los activos admitidos, obtén tipos de cambio y detalles de activos.

Versión de API: Compatible con la versión 2024-12-12 de Crypto APIs

Características

Lista activos cripto y fiduciarios admitidos con filtrado y paginación
Obtén tipos de cambio entre dos activos cualesquiera (por símbolo o ID de activo)
Obtén detalles de activos por ID de activo o símbolo

Requisitos previos

Node.js 18+
Cuenta y clave de API de Crypto APIs (regístrate | obtén clave de API)

Instalación

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

O instala todos los servidores MCP de 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

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):

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

Cursor

Añade a .cursor/mcp.json (proyecto) o ~/.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

Inicia el servidor en modo HTTP:

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

En tu flujo de trabajo de n8n, añade un nodo AI Agent
En Tools, añade un MCP Client Tool y establece la URL a http://localhost:3000/mcp

n8n en Docker: localhost dentro del contenedor no es tu máquina. Inicia el servidor con --host 0.0.0.0 y MCP_AUTH_TOKEN configurados (consulta Exponer el servidor más allá de localhost), usa http://host.docker.internal:3000/mcp como URL y añade un encabezado Authorization: Bearer <token> a la credencial del MCP Client Tool.

Todos los servidores usan el puerto 3000 por defecto. Usa --port para asignar puertos diferentes al ejecutar varios servidores.

Herramientas disponibles

`market_data_metadata`

Acción	Descripción
`list-supported-assets`	Lista activos cripto y fiduciarios admitidos. Opcional: `limit`, `offset`, `type` (cripto/fiduciario)

`market_data_exchange_rates`

Acción	Descripción
`get-exchange-rate-by-asset-symbols`	Obtén el tipo de cambio entre dos activos por símbolo (p. ej., BTC a USD)
`get-exchange-rate-by-asset-ids`	Obtén el tipo de cambio entre dos activos por ID de activo

`market_data_assets`

Acción	Descripción
`get-asset-details-by-asset-id`	Obtén detalles de activo por ID de activo único
`get-asset-details-by-asset-symbol`	Obtén detalles de activo por símbolo (p. ej., BTC, ETH)

Argumentos de CLI

Argumento	Descripción	Predeterminado
`--api-key`	Clave de API de Crypto APIs	Variable de entorno `CRYPTOAPIS_API_KEY`
`--transport`	Tipo de transporte: `stdio` o `http`	`stdio`
`--host`	Host HTTP (usa `0.0.0.0` para aceptar conexiones remotas — requiere un token de autenticación con `--api-key`)	`127.0.0.1`
`--auth-token`	Token Bearer que deben enviar los llamadores (`Authorization: Bearer <token>`); prefiere la variable de entorno `MCP_AUTH_TOKEN`	Variable de entorno `MCP_AUTH_TOKEN`
`--allowed-hosts`	Lista de permitidos del encabezado `Host` separada por comas para enlaces no loopback	—
`--port`	Puerto HTTP	`3000`
`--path`	Ruta HTTP	`/mcp`
`--stateless`	Habilita el modo HTTP sin estado	`false`

Modos de clave de API HTTP

Al usar transporte HTTP, el servidor admite dos modos de clave de API:

Con --api-key: La clave se usa para todas las solicitudes. Los encabezados de solicitud x-api-key se ignoran.
Sin --api-key: Cada solicitud debe incluir un encabezado x-api-key con una clave válida de Crypto APIs. Esto permite alojar un servidor público donde cada usuario proporciona su propia clave.

# 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

Exponer el servidor más allá de localhost

El modo HTTP escucha en 127.0.0.1 por defecto, por lo que solo los procesos en la misma máquina pueden alcanzarlo. Para aceptar conexiones de otras máquinas o contenedores, enlaza explícitamente y protege el puerto:

# 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 el encabezado Host (protección contra rebinding de DNS) cuando no está enlazado a loopback. Prefiere MCP_AUTH_TOKEN sobre --auth-token: los argumentos de línea de comandos son visibles en la lista de procesos.

El transporte Stdio siempre requiere una clave de API al inicio.

Importante: Clave de API requerida

Advertencia: Realizar solicitudes sin una clave de API válida — o con una incorrecta — puede resultar en el bloqueo de tu IP en el ecosistema de Crypto APIs. Asegúrate siempre de que una clave de API válida esté configurada antes de iniciar cualquier servidor.

Servidor MCP remoto

Crypto APIs proporciona un servidor MCP remoto oficial con todas las herramientas disponibles mediante transporte HTTP Streamable en https://ai.cryptoapis.io/mcp. Pasa tu clave de API mediante el encabezado x-api-key — no se requiere instalación.

Licencia

MIT