Bybit MCP Server

Ein Model Context Protocol (MCP) -Server, der schreibgeschützten Zugriff auf die Kryptowährungsaustausch-API von Bybit bietet.

DIES IST SOFTWARE IN ALPHA-QUALITÄT – DIE VERWENDUNG ERFOLGT AUF EIGENES RISIKO!

Verwenden Sie für diesen Server ausschließlich einen schreibgeschützten API-Schlüssel. Ich würde meinem Code Ihr „Geld“ nicht anvertrauen, und Sie sollten das auch nicht tun!

Merkmale

Dieser MCP-Server bietet die folgenden Tools für die Interaktion mit der API von Bybit:

• get_ticker : Holen Sie sich Echtzeit-Tickerinformationen für ein Handelspaar

• get_orderbook : Orderbuchdaten (Markttiefe) für ein Handelspaar abrufen

• get_kline : Holen Sie sich Kline-/Candlestick-Daten für ein Handelspaar

• get_market_info : Erhalten Sie detaillierte Marktinformationen für Handelspaare

• get_trades : Aktuelle Trades für ein Handelspaar abrufen

• get_instrument_info : Erhalten Sie detaillierte Instrumenteninformationen für ein bestimmtes Handelspaar

• get_wallet_balance : Ruft Informationen zum Wallet-Guthaben des authentifizierten Benutzers ab

• get_positions : Aktuelle Positionsinformationen für den authentifizierten Benutzer abrufen

• get_order_history : Bestellverlauf für den authentifizierten Benutzer abrufen

• get_ml_rsi : Holen Sie sich den auf maschinellem Lernen basierenden RSI (Relative Strength Index) für ein Handelspaar

• get_market_structure : Marktstrukturinformationen für ein Handelspaar abrufen

• get_order_blocks : Erkennen institutioneller Auftragsakkumulationszonen

• get_order_history : Bestellverlauf für den authentifizierten Benutzer abrufen

• get_orderbook : Orderbuchdaten (Markttiefe) für ein Handelspaar abrufen

• get_ticker : Holen Sie sich Echtzeit-Tickerinformationen für ein Handelspaar

Es gibt auch eine hochgradig experimentelle WebUI. Weitere Informationen finden Sie in der README-Datei zur WebUI .

Während ich dieses Projekt weiterentwickle, kann es am gesamten Code zu gravierenden Änderungen und der Hinzufügung bzw. Entfernung von Funktionen kommen.

Related MCP server: Binance MCP Server

Voraussetzungen & Installation

1. Node.js (v22+)

2. pnpm ( npm i -g pnpm )

3. Wenn Sie den Ollama-Client wie in der Schnellstartanleitung unten gezeigt ausführen möchten, müssen Sie Ollama sowie das Modell Ihrer Wahl installiert und ausgeführt haben.

pnpm i

Schnellstart

Um Pakete zu installieren, erstellen Sie alles und starten Sie den interaktiven Client:

pnpm i

Kopieren Sie die Datei .env.example nach .env und geben Sie Ihre Daten ein.

cp .env.example .env
code .env

MCP-Server (nur)

Stdio-Transport (Standard)

pnpm serve

HTTP/SSE-Transport

pnpm start:http

Der HTTP-Server läuft standardmäßig auf Port 8080 und bietet sowohl modernes streambares HTTP als auch ältere SSE-Transporte. Dadurch ist er mit Webanwendungen und verschiedenen MCP-Clients kompatibel. Detaillierte Informationen finden Sie in der HTTP-Serverdokumentation .

MCP-Server und Ollama-Client

Installieren Sie die erforderlichen Clientpakete:

(cd client && pnpm i)

Kopieren Sie die Client-Datei .env.example nach .env und geben Sie Ihre Daten ein.

cp client/.env.example client/.env
code client/.env

So starten Sie Client und Server mit einem Befehl:

pnpm start

Konfiguration

Umgebungsvariablen

Der Server erfordert, dass die Bybit-API-Anmeldeinformationen als Umgebungsvariablen festgelegt werden:

• BYBIT_API_KEY : Ihr Bybit-API-Schlüssel (erforderlich)

• BYBIT_API_SECRET : Ihr Bybit-API-Geheimnis (erforderlich) – WICHTIG – Erstellen Sie immer nur einen schreibgeschützten API-Schlüssel!

• BYBIT_USE_TESTNET : Auf „true“ setzen, um Testnet statt Mainnet zu verwenden (optional, standardmäßig auf „false“ gesetzt)

• DEBUG : Auf „true“ setzen, um die Debug-Protokollierung zu aktivieren (optional, standardmäßig „false“)

Client-Umgebungsvariablen (./client/.env):

• OLLAMA_HOST : Der Host des Ollama-Servers (standardmäßig http://localhost:11434 )

• DEFAULT_MODEL : Das für den Chat zu verwendende Standardmodell (standardmäßig qwen3-30b-a3b-ud-nothink-128k:q4_k_xl)

MCP-Einstellungskonfiguration

Um diesen Server mit MCP-Clients zu verwenden, müssen Sie ihn zu Ihrer MCP-Konfigurationsdatei hinzufügen. Der Speicherort der Datei hängt von Ihrem Client ab:

MCP-Beispiel - Claude Desktop

Speicherort: ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bybit": {
      "command": "node",
      "args": ["/path/to/bybit-mcp/build/index.js"],
      "env": {
        "BYBIT_API_KEY": "your-api-key",
        "BYBIT_API_SECRET": "your-api-secret",
        "BYBIT_USE_TESTNET": "false"
      }
    }
  }
}

MCP-Beispiel – gomcp

Speicherort: ~/.config/gomcp/config.yaml

mcp_servers:
  - name: "bybit"
    command: "cd /path/to/bybit-mcp && pnpm run serve"
    arguments: []
    env:
      BYBIT_API_KEY: ""      # Add your Bybit API **READ ONLY** key here
      BYBIT_API_SECRET: ""   # Add your Bybit API **READ ONLY** secret here
      BYBIT_USE_TESTNET: "true"  # Set to false for production
      DEBUG: "false"         # Optional: Set to true for debug logging

Client-Integration

Dieses Paket enthält einen TypeScript-Client, der eine Kommandozeilenschnittstelle für die Interaktion mit Ollama-LLMs und dem bybit-mcp-Server bereitstellt. Der Client unterstützt:

• Interaktiver Chat mit Ollama-Modellen

• Direkter Zugriff auf alle bybit-mcp-Handelstools

• Automatische Serververwaltung

• Umgebungsbasierte Konfiguration

• Debug-Protokollierung

Eine ausführliche Client-Dokumentation finden Sie in der README-Datei des Clients .

Ausführen des Servers

Produktion

1. Erstellen Sie den Server:

pnpm build

2. Führen Sie den Server aus:

node build/index.js

Entwicklung

Für die Entwicklung mit automatischer TypeScript-Neukompilierung:

pnpm watch

So überprüfen Sie den MCP-Server während der Entwicklung:

pnpm inspector

Tool-Dokumentation

Tickerinformationen abrufen

{
  "name": "get_ticker",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot" // optional, defaults to "spot"
  }
}

Orderbuchdaten abrufen

{
  "name": "get_orderbook",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "limit": 25 // optional, defaults to 25 (available: 1, 25, 50, 100, 200)
  }
}

Kline/Candlestick-Daten abrufen

{
  "name": "get_kline",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "interval": "1", // optional, defaults to "1" (available: "1", "3", "5", "15", "30", "60", "120", "240", "360", "720", "D", "M", "W")
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

Marktinformationen erhalten

{
  "name": "get_market_info",
  "arguments": {
    "category": "spot", // optional, defaults to "spot"
    "symbol": "BTCUSDT", // optional, if not provided returns info for all symbols in the category
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

Aktuelle Trades abrufen

{
  "name": "get_trades",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

Instrumenteninformationen abrufen

{
  "name": "get_instrument_info",
  "arguments": {
    "symbol": "BTCUSDT", // required
    "category": "spot" // optional, defaults to "spot"
  }
}

Gibt detaillierte Informationen zu einem Handelsinstrument zurück, darunter:

• Basis- und Notierungswährungen

• Handelsstatus

• Losgrößenfilter (Mindest-/Maximalbestellmengen)

• Preisfilter (Tickgröße)

• Hebeleinstellungen (für Futures)

• Vertragsdetails (für Futures)

Wallet-Guthaben abrufen

{
  "name": "get_wallet_balance",
  "arguments": {
    "accountType": "UNIFIED", // required (available: "UNIFIED", "CONTRACT", "SPOT")
    "coin": "BTC" // optional, if not provided returns all coins
  }
}

Positionen abrufen

{
  "name": "get_positions",
  "arguments": {
    "category": "linear", // required (available: "linear", "inverse")
    "symbol": "BTCUSDT", // optional
    "baseCoin": "BTC", // optional
    "settleCoin": "USDT", // optional
    "limit": 200 // optional, defaults to 200
  }
}

Bestellverlauf abrufen

{
  "name": "get_order_history",
  "arguments": {
    "category": "spot", // required (available: "spot", "linear", "inverse")
    "symbol": "BTCUSDT", // optional
    "baseCoin": "BTC", // optional
    "orderId": "1234567890", // optional
    "orderLinkId": "myCustomId", // optional
    "orderStatus": "Filled", // optional (available: "Created", "New", "Rejected", "PartiallyFilled", "PartiallyFilledCanceled", "Filled", "Cancelled", "Untriggered", "Triggered", "Deactivated")
    "orderFilter": "Order", // optional (available: "Order", "StopOrder")
    "limit": 200 // optional, defaults to 200
  }
}

Unterstützte Kategorien

• spot : Spothandel

• linear : Lineare unbefristete Verträge

• inverse : Inverse unbefristete Verträge

Lizenz

MIT