CCXT MCP Server

CCXT MCP Server

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server, der verschiedene Funktionen aus der CCXT- Bibliothek als Tools für Large Language Models (LLMs) bereitstellt.

Es ermöglicht LLMs, auf standardisierte und asynchrone Weise mit Kryptowährungsbörsen zu interagieren und Aufgaben wie das Abrufen von Guthaben, Marktdaten, das Erstellen von Aufträgen und mehr auszuführen.

Dieser Server wurde mit FastMCP erstellt, was die Erstellung von MCP-Servern in Python vereinfacht.

Merkmale

• CCXT-Integration : Umfasst allgemeine CCXT-Funktionen für die Austauschinteraktion.
• Asynchron : Erstellt mit asyncio und ccxt.async_support für effiziente, nicht blockierende Vorgänge.
• Klare Tool-Definitionen : Verwendet typing.Annotated und pydantic.Field für klare Parameterbeschreibungen und Einschränkungen, wodurch es für LLMs (und Entwickler) einfacher wird, die Tools zu verstehen und zu verwenden.
• Authentifizierungshandhabung : Unterstützt die Authentifizierung per API-Schlüssel, Geheimnis und Passphrase für private Endpunkte.
• Öffentliche und private Tools : Bietet separate Tools für öffentliche Marktdaten und private Kontoaktionen.

Installation

1. Klonen Sie das Repository (falls Sie dies noch nicht getan haben):
   git clone https://github.com/jcwleo/ccxt-mcp-server.git cd ccxt-mcp-server
2. Erstellen und aktivieren Sie eine virtuelle Umgebung (empfohlen):
   python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
3. Abhängigkeiten installieren: Die benötigten Bibliotheken sind in requirements.txt aufgelistet. Sie können sie mit pip oder uv installieren.
   • Verwenden von pip :
     pip install -r requirements.txt
   • Verwenden von uv (falls installiert):
     uv pip install -r requirements.txt # Or, if you prefer uv's environment management: # uv sync

Ausführen des Servers

Sobald die Abhängigkeiten installiert sind, können Sie den MCP-Server direkt ausführen:

Sie sollten eine Ausgabe sehen, die angibt, dass der Server gestartet wurde, ähnlich der folgenden:

Der Server steht dann für MCP-Clients zur Verbindung zur Verfügung (normalerweise über einen von FastMCP verwalteten Standardport, sofern nicht anders konfiguriert).

MCP-Serverkonfiguration (für MCP-Clients)

Wenn Sie einen MCP-Client verwenden, der eine manuelle Serverkonfiguration erfordert (wie die Claude-Desktop-App), müssen Sie eine Konfiguration bereitstellen, die dem folgenden JSON ähnelt.

Erstellen Sie eine Datei claude_desktop_config.json (oder das Äquivalent für Ihren MCP-Client) mit der folgenden Struktur:

Wichtig:

• Ersetzen Sie "/path/to/your/ccxt-mcp-server" durch den tatsächlichen absoluten Pfad zu dem Verzeichnis, in das Sie dieses ccxt-mcp-server Projekt geklont oder heruntergeladen haben (also das Verzeichnis, das mcp_server.py enthält).
• Der "command" und "args" hängen davon ab, wie Sie Python-Projekte ausführen und ob Sie uv oder eine virtuelle Umgebung verwenden. Das obige Beispiel verwendet uv .
  • Wenn Sie eine virtuelle Umgebung direkt mit python verwenden, könnte der Befehl folgendermaßen aussehen:
    { "mcpServers": { "ccxt-mcp-server": { "command": "/path/to/your/.venv/bin/python", // Or `python.exe` on Windows "args": [ "mcp_server.py" ], "workingDirectory": "/path/to/your/ccxt-mcp-server" } } }
    Stellen Sie sicher, dass der command auf die ausführbare Python-Datei in Ihrer virtuellen Umgebung verweist und dass workingDirectory auf das Stammverzeichnis des Projekts eingestellt ist.

Diese Konfiguration teilt Ihrem MCP-Client mit, wie er den CCXT MCP-Server starten und mit ihm kommunizieren soll.

Verfügbare MCP-Tools

Dieser Server stellt die folgenden Tools bereit, kategorisiert danach, ob sie eine API-Authentifizierung erfordern.

Tools, die eine API-Authentifizierung erfordern (privat)

• fetch_account_balance : Ruft den aktuellen Kontostand ab.
• fetch_deposit_address : Ruft die Einzahlungsadresse für eine Währung ab.
• withdraw_cryptocurrency : Hebt Kryptowährung an eine angegebene Adresse ab.
• fetch_open_positions : Ruft offene Positionen ab (hauptsächlich für Futures/Derivate).
• set_trading_leverage : Legt den Hebel für ein Handelssymbol fest (hauptsächlich für Futures).
• create_spot_limit_order : Platziert eine neue Spot-Limit-Order.
• create_spot_market_order : Platziert eine neue Spotmarkt-Order.
• create_futures_limit_order : Platziert eine neue Futures-Limit-Order.
• create_futures_market_order : Platziert eine neue Futures-Marktorder.
• cancel_order : Storniert eine bestehende offene Bestellung.
• fetch_order_history : Ruft den Verlauf der Bestellungen (offen/geschlossen) ab.
• fetch_my_trade_history : Ruft den Verlauf der vom Benutzer ausgeführten Trades ab.

Tools für öffentliche Daten (keine Authentifizierung erforderlich)

• fetch_ohlcv : Ruft historische OHLCV-Daten (Candlestick) ab.
• fetch_funding_rate : Ruft den Finanzierungssatz für einen unbefristeten Terminkontrakt ab.
• fetch_long_short_ratio : Ruft das Long/Short-Verhältnis ab (erfordert börsenspezifische params ).
• fetch_option_contract_data : Ruft Marktdaten für einen Optionsvertrag ab.
• fetch_market_ticker : Ruft die neuesten Preistickerdaten für ein Symbol ab.
• fetch_public_market_trades : Ruft aktuelle öffentliche Trades für ein Symbol ab.

Jedes Tool verfügt dank der Verwendung von Annotated und pydantic.Field über detaillierte Parameterbeschreibungen, die über das MCP-Protokoll selbst verfügbar sind.

Verwendungshinweise

• Futures/Optionen : Wenn Sie Tools im Zusammenhang mit Futures oder Optionen verwenden (z. B. fetch_open_positions , create_futures_limit_order , fetch_funding_rate ), stellen Sie sicher, dass Sie den CCXT-Client über das Argument „ params “ richtig konfigurieren. Übergeben Sie insbesondere {'options': {'defaultType': 'future'}} (oder 'swap' , 'option' nach Bedarf), wenn die Börse dies erfordert oder nicht standardmäßig den gewünschten Markttyp verwendet.
• fetch_long_short_ratio : Dies ist keine einheitliche CCXT-Standardmethode. Sie müssen den spezifischen Namen der Austauschmethode und ihre Parameter im Argument „ params angeben (z. B. params={'method_name': 'fapiPublicGetGlobalLongShortAccountRatio', 'method_params': {'symbol': 'BTCUSDT', 'period': '5m'}} für Binance-Futures).
• Fehlerbehandlung : Tools geben ein Wörterbuch mit einem "error" -Schlüssel zurück, wenn während des CCXT-Aufrufs ein Problem auftritt.