@luziadev/mcp-server

Servidor del Protocolo de Contexto de Modelo (MCP) para datos de precios de criptomonedas. Ofrece a asistentes de IA como Claude acceso en tiempo real a precios de tickers, información de exchanges e historial OHLCV desde la API de Luzia.

Características

• Precios de tickers en tiempo real de múltiples exchanges (Binance, Coinbase, Kraken, OKX, Bybit)

• Datos históricos de velas OHLCV para análisis técnico

• Información de mercado y pares de trading

• Estado y disponibilidad de los exchanges

Requisitos

• Una clave de API de Luzia (consíguela aquí)

Conexión remota (recomendado)

La forma más rápida de usar Luzia con tu asistente de IA es conectarte a nuestro servidor MCP alojado en https://mcp.luzia.dev/mcp. No requiere instalación. Solo pega la URL y tu clave de API.

Claude.ai web / Consola de Anthropic

Configuración → Integraciones → Añadir MCP personalizado:

• URL: https://mcp.luzia.dev/mcp

• Autenticación: Token Bearer — pega tu clave de API (lz_...)

Claude Desktop (vía mcp-remote)

El soporte nativo de MCP remoto de Claude Desktop aún se está desplegando, por lo que la forma más sencilla hoy en día es el shim mcp-remote, que conecta un MCP HTTP remoto a la interfaz stdio de Claude Desktop.

Edita tu configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.luzia.dev/mcp",
        "--header",
        "Authorization:Bearer lz_your_api_key"
      ]
    }
  }
}

Reinicia Claude Desktop (Cmd+Q en macOS) y empieza a hacer preguntas.

VS Code, Cursor, Cline, Continue.dev

Pega la URL y el encabezado de Autorización en la configuración de MCP de tu herramienta:

• URL: https://mcp.luzia.dev/mcp

• Encabezado: Authorization: Bearer lz_your_api_key

Inspector MCP

npx @modelcontextprotocol/inspector

Luego apunta el inspector a https://mcp.luzia.dev/mcp y añade el encabezado Authorization: Bearer lz_....

Instalación local (avanzado)

¿Prefieres ejecutar el servidor localmente? @luziadev/mcp-server sigue estando disponible en npm y se ejecuta sobre stdio.

# Run directly with npx (no install needed)
LUZIA_API_KEY=lz_your_api_key npx -y @luziadev/mcp-server --stdio

Configuración de Claude Desktop (stdio local)

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Configuración de Claude Code (stdio local)

Añade a .claude/settings.json:

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Herramientas disponibles

Prompts disponibles

Los prompts son plantillas de análisis preconstruidas que obtienen datos y generan información estructurada. Están disponibles en clientes que soportan prompts de MCP (ej. Claude Desktop a través del menú /).

Nota: Claude Code no soporta prompts de MCP directamente — usa lenguaje natural en su lugar (ej. "Analiza el movimiento de precio de BTC/USDT en Binance") y llamará a las herramientas subyacentes automáticamente.

Ejemplos de prompts

analyze_price_movement

Obtiene datos actuales del ticker y analiza el spread bid-ask, estadísticas de 24h y volumen.

Argumentos:

• exchange (requerido): ej. "binance", "coinbase"

• symbol (requerido): ej. "BTC/USDT", "ETH/USD"

Claude Desktop: Escribe / → selecciona analyze_price_movement → rellena exchange: binance, symbol: BTC/USDT

Lenguaje natural (cualquier cliente): "Analiza el movimiento actual del precio de BTC/USDT en Binance"

analyze_ohlcv

Obtiene datos históricos de velas y solicita análisis técnico incluyendo tendencias, soporte/resistencia, patrones de volumen y patrones de velas.

Argumentos:

• exchange (requerido): ej. "binance"

• symbol (requerido): ej. "BTC/USDT"

• interval (opcional): "1m", "5m", "15m", "1h", "1d" (por defecto: "1h")

• period (opcional): ej. "24h", "7d", "30d" (por defecto: "24h")

Claude Desktop: Escribe / → selecciona analyze_ohlcv → rellena exchange: binance, symbol: BTC/USDT, interval: 1h

Lenguaje natural (cualquier cliente): "Analiza las velas OHLCV de BTC/USDT en Binance con un intervalo de 1h durante los últimos 7 días"

compare_exchanges

Obtiene datos de ticker de múltiples exchanges y compara precios, spreads y liquidez para análisis de arbitraje.

Argumentos:

• symbol (requerido): ej. "BTC/USDT"

• exchanges (opcional): lista separada por comas, ej. "binance,coinbase,kraken" (por defecto: "binance,coinbase,kraken")

Claude Desktop: Escribe / → selecciona compare_exchanges → rellena symbol: BTC/USDT

Lenguaje natural (cualquier cliente): "Compara los precios de BTC/USDT en todos los exchanges"

Límites de tasa

Heredados de tu nivel de suscripción de Luzia:

• Gratuito: 100 solicitudes/minuto, 5.000/día

• Pro: 1.000 solicitudes/minuto, 20.000/día

Solución de problemas

Errores de "Unauthorized"

• Remoto: verifica que tu encabezado Authorization: Bearer lz_... esté configurado y que la clave comience con lz_.

• Stdio: verifica que LUZIA_API_KEY esté configurada en la configuración de tu cliente MCP y que la clave no haya sido revocada.

Errores de sesión remota

• Si tu cliente informa "Unknown session id", el servidor se reinició o tu sesión expiró (30 min de inactividad). Reconecta y el cliente se reinicializará automáticamente.

Claude Desktop no encuentra el servidor (stdio)

• Verifica que claude_desktop_config.json sea un JSON válido.

• Asegúrate de que Node.js 20+ esté instalado (node --version).

• Reinicia Claude Desktop completamente (Cmd+Q en macOS).

Licencia

MIT - ver LICENSE para más detalles.