Skip to main content
Glama
Sign In
deenesjakoruzh

Bybit MCP Server

by sammcj
npmGitHub
TypeScript
MIT License
14
9
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 .

WebUI-Screenshot

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

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
  1. 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Ein Model Context Protocol-Server, der schreibgeschützten Zugriff auf die Kryptowährungs-Austausch-API von Bybit bietet und es Benutzern ermöglicht, Kryptowährungsdaten in Echtzeit in natürlicher Sprache abzufragen.

  1. Merkmale
    1. Voraussetzungen & Installation
      1. Schnellstart
        1. MCP-Server (nur)
        2. MCP-Server und Ollama-Client
      2. Konfiguration
        1. Umgebungsvariablen
        2. MCP-Einstellungskonfiguration
      3. Client-Integration
        1. Ausführen des Servers
          1. Produktion
          2. Entwicklung
        2. Tool-Dokumentation
          1. Tickerinformationen abrufen
          2. Orderbuchdaten abrufen
          3. Kline/Candlestick-Daten abrufen
          4. Marktinformationen erhalten
          5. Aktuelle Trades abrufen
          6. Instrumenteninformationen abrufen
          7. Wallet-Guthaben abrufen
          8. Positionen abrufen
          9. Bestellverlauf abrufen
        3. Unterstützte Kategorien
          1. Lizenz

            Related Resources

            Related MCP Servers

            • Coin MCP Server

              longmans
              A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data, enabling AI applications to retrieve cryptocurrency listings, quotes, and detailed information.
              Last updated -
              3
              10
              Python
              • Linux
              • Apple

            • Binance MCP Server

              tienan92it
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.
              Last updated -
              4
              Python
              MIT License

            • Realtime Crypto MCP Server

              smhnkmr
              -
              security
              -
              license
              -
              quality
              A server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.
              Last updated -
              1
              TypeScript
              MIT License

            • Satstream MCP Serverofficial

              satstream
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables querying Bitcoin blockchain data, including address information, transaction details, mempool statistics, and ordinals/runes data through the Satstream API.
              Last updated -
              37
              TypeScript
              MIT License

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/sammcj/bybit-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server