@luziadev/mcp-server

Model Context Protocol (MCP) Server für Kryptowährungs-Preisdaten. Gibt KI-Assistenten wie Claude Echtzeit-Zugriff auf Ticker-Preise, Börseninformationen und OHLCV-Historie von der Luzia API.

Funktionen

• Echtzeit-Ticker-Preise von mehreren Börsen (Binance, Coinbase, Kraken, OKX, Bybit)

• Historische OHLCV-Candlestick-Daten für technische Analysen

• Marktinformationen und Handelspaare

• Börsenstatus und Verfügbarkeit

Anforderungen

• Ein Luzia API-Schlüssel (hier erhalten)

Remote-Verbindung (empfohlen)

Der schnellste Weg, Luzia mit Ihrem KI-Assistenten zu nutzen, ist die Verbindung zu unserem gehosteten MCP-Server unter https://mcp.luzia.dev/mcp. Keine Installation erforderlich. Fügen Sie einfach die URL und Ihren API-Schlüssel ein.

Claude.ai Web / Anthropic Konsole

Einstellungen → Integrationen → Add custom MCP:

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

• Authentifizierung: Bearer-Token — fügen Sie Ihren API-Schlüssel ein (lz_...)

Claude Desktop (via mcp-remote)

Die native Remote-MCP-Unterstützung von Claude Desktop wird derzeit ausgerollt. Der einfachste Weg ist daher das mcp-remote Shim, das eine Brücke zwischen einem Remote-HTTP-MCP und der stdio-Schnittstelle von Claude Desktop schlägt.

Bearbeiten Sie Ihre Konfiguration:

• 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"
      ]
    }
  }
}

Starten Sie Claude Desktop neu (Cmd+Q unter macOS) und beginnen Sie, Fragen zu stellen.

VS Code, Cursor, Cline, Continue.dev

Fügen Sie die URL und den Authorization-Header in die MCP-Einstellungen Ihres Tools ein:

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

• Header: Authorization: Bearer lz_your_api_key

MCP Inspector

npx @modelcontextprotocol/inspector

Zeigen Sie dann mit dem Inspector auf https://mcp.luzia.dev/mcp und fügen Sie den Header Authorization: Bearer lz_... hinzu.

Lokale Installation (fortgeschritten)

Bevorzugen Sie es, den Server lokal auszuführen? @luziadev/mcp-server ist weiterhin über npm verfügbar und läuft über stdio.

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

Claude Desktop Konfiguration (lokales stdio)

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

Claude Code Konfiguration (lokales stdio)

Fügen Sie dies zu .claude/settings.json hinzu:

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

Verfügbare Tools

Verfügbare Prompts

Prompts sind vorgefertigte Analysevorlagen, die Daten abrufen und strukturierte Erkenntnisse generieren. Sie sind in Clients verfügbar, die MCP-Prompts unterstützen (z. B. Claude Desktop über das /-Menü).

Hinweis: Claude Code unterstützt MCP-Prompts nicht direkt — verwenden Sie stattdessen natürliche Sprache (z. B. "Analysiere die BTC/USDT-Preisbewegung auf Binance"), und es wird die zugrunde liegenden Tools automatisch aufrufen.

Prompt-Beispiele

analyze_price_movement

Ruft aktuelle Ticker-Daten ab und analysiert Bid-Ask-Spreads, 24h-Statistiken und Volumen.

Argumente:

• exchange (erforderlich): z. B. "binance", "coinbase"

• symbol (erforderlich): z. B. "BTC/USDT", "ETH/USD"

Claude Desktop: Geben Sie / ein → wählen Sie analyze_price_movement → füllen Sie exchange: binance, symbol: BTC/USDT aus

Natürliche Sprache (jeder Client): "Analysiere die aktuelle BTC/USDT-Preisbewegung auf Binance"

analyze_ohlcv

Ruft historische Candlestick-Daten ab und fordert eine technische Analyse an, einschließlich Trends, Unterstützung/Widerstand, Volumenmustern und Candlestick-Mustern.

Argumente:

• exchange (erforderlich): z. B. "binance"

• symbol (erforderlich): z. B. "BTC/USDT"

• interval (optional): "1m", "5m", "15m", "1h", "1d" (Standard: "1h")

• period (optional): z. B. "24h", "7d", "30d" (Standard: "24h")

Claude Desktop: Geben Sie / ein → wählen Sie analyze_ohlcv → füllen Sie exchange: binance, symbol: BTC/USDT, interval: 1h aus

Natürliche Sprache (jeder Client): "Analysiere BTC/USDT OHLCV-Kerzen auf Binance mit 1h-Intervall für die letzten 7 Tage"

compare_exchanges

Ruft Ticker-Daten von mehreren Börsen ab und vergleicht Preise, Spreads und Liquidität für Arbitrage-Analysen.

Argumente:

• symbol (erforderlich): z. B. "BTC/USDT"

• exchanges (optional): durch Kommas getrennte Liste, z. B. "binance,coinbase,kraken" (Standard: "binance,coinbase,kraken")

Claude Desktop: Geben Sie / ein → wählen Sie compare_exchanges → füllen Sie symbol: BTC/USDT aus

Natürliche Sprache (jeder Client): "Vergleiche BTC/USDT-Preise über alle Börsen hinweg"

Ratenbegrenzungen

Abhängig von Ihrem Luzia-Abonnement-Level:

• Kostenlos: 100 Anfragen/Minute, 5.000/Tag

• Pro: 1.000 Anfragen/Minute, 20.000/Tag

Fehlerbehebung

"Unauthorized"-Fehler

• Remote: Überprüfen Sie, ob Ihr Authorization: Bearer lz_...-Header gesetzt ist und der Schlüssel mit lz_ beginnt.

• Stdio: Überprüfen Sie, ob LUZIA_API_KEY in Ihrer MCP-Client-Konfiguration gesetzt ist und der Schlüssel nicht widerrufen wurde.

Remote-Sitzungsfehler

• Wenn Ihr Client "Unknown session id" meldet, wurde der Server neu gestartet oder Ihre Sitzung ist abgelaufen (30 Min. Inaktivität). Verbinden Sie sich erneut, und der Client wird automatisch neu initialisiert.

Claude Desktop findet den Server nicht (stdio)

• Überprüfen Sie, ob claude_desktop_config.json gültiges JSON ist.

• Stellen Sie sicher, dass Node.js 20+ installiert ist (node --version).

• Starten Sie Claude Desktop vollständig neu (Cmd+Q unter macOS).

Lizenz

MIT - siehe LICENSE für Details.