MCP Paradex Server

Model Context Protocol (MCP)-Serverimplementierung für die Paradex-Handelsplattform.

Überblick

Dieses Projekt schlägt eine Brücke zwischen KI-Assistenten (wie Claude) und der Paradex-Plattform für den Handel mit unbefristeten Futures. Mithilfe des MCP-Standards können KI-Assistenten:

Marktdaten von Paradex abrufen
Handelskonten und Tresore verwalten
Bestellungen aufgeben und verwalten
Positionen und Saldo überwachen

Voraussetzungen

Python 3.10+

Installation

Installation über Smithery

So installieren Sie mcp-paradex-py für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

Verwendung von UV (schnellere Alternative)

Klonen Sie dieses Repository:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
Erstellen Sie eine virtuelle Umgebung:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
Installieren Sie Abhängigkeiten:
uv pip install -e .

Konfiguration

Richten Sie Ihre Konfiguration ein:

cp .env.template .env

Bearbeiten Sie dann die .env Datei mit Ihren Paradex-Anmeldeinformationen.

Ausführen des Servers

Docker (empfohlen)

docker build . -t sv/mcp-paradex-py

Fügen Sie im Cursor MCP als Befehl hinzu

Nur für die Öffentlichkeit

docker run --rm -i sv/mcp-paradex-py

Handel zulassen

docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=0xprivatekey -i sv/mcp-paradex-py

Smithery.ai-Integration

Dieser MCP-Server ist mit Smithery.ai kompatibel, einer Plattform zum Erkennen und Bereitstellen von MCP-Servern.

Claude Desktop-Konfiguration

So verwenden Sie diesen Server mit Claude Desktop über Smithery.ai:

Öffnen Sie Claude Desktop und aktivieren Sie den Entwicklermodus über das Menü
Gehen Sie zu Einstellungen > Entwickler und klicken Sie auf „Konfiguration bearbeiten“.
Fügen Sie Ihrer claude_desktop_config.json die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

Ersetzen Sie your_ethereum_private_key durch Ihren tatsächlichen Paradex-Private-Key
Speichern Sie die Datei und starten Sie Claude Desktop neu

Smithery.ai-Registrierung

Der Server enthält eine smithery.yaml Datei mit Metadaten für das Smithery.ai-Register. Wenn Sie diesen Server in Smithery.ai veröffentlichen möchten, können Sie die Smithery-CLI verwenden:

# Install Smithery CLI
npm install -g @smithery/cli

# Login to Smithery
smithery login

# Publish the server
smithery publish

Weitere Informationen zum Veröffentlichen in Smithery.ai finden Sie in der Smithery-Dokumentation .

Verfügbare Ressourcen und Tools

Ressourcen

Systemressourcen

paradex://system/config - Ruft die Paradex-Systemkonfiguration und grundlegende Informationen zum Austausch ab
paradex://system/time - Aktuelle Systemzeit in Millisekunden seit Epoche abrufen
paradex://system/state - Ruft den aktuellen Betriebszustand des Paradex-Systems ab

Marktressourcen

paradex://markets - Holen Sie sich eine Liste der verfügbaren Märkte von Paradex
paradex://market/summary/{market_id} – Erhalten Sie detaillierte Marktinformationen für ein bestimmtes Handelspaar

Vault-Ressourcen

paradex://vaults - Listet alle auf Paradex verfügbaren Tresore auf
paradex://vaults/config - Globale Konfiguration für Tresore abrufen
paradex://vaults/balance/{vault_id} – Ruft den Kontostand eines bestimmten Tresors ab
paradex://vaults/summary/{vault_id} – Erhalten Sie eine umfassende Zusammenfassung eines Tresors
paradex://vaults/transfers/{vault_id} – Ein- und Auszahlungsverlauf für einen Tresor abrufen
paradex://vaults/positions/{vault_id} - Aktuelle Handelspositionen für einen Tresor abrufen
paradex://vaults/account-summary/{vault_id} - Handelskontoinformationen für einen Tresor abrufen

Werkzeuge

Systemtools

paradex_system_config - Globale Paradex-Systemkonfiguration abrufen
paradex_system_state - Aktuellen Systemstatus abrufen

Markttools

paradex_markets - Erhalten Sie detaillierte Informationen zu Märkten, einschließlich Basis-/Kurswerten, Tick-Größe und anderen Handelsparametern
paradex_market_summaries - Erhalten Sie Zusammenfassungen mit Preis, Volumen, 24-Stunden-Änderung und anderen wichtigen Marktkennzahlen
paradex_funding_data - Erhalten Sie historische Finanzierungsratendaten für unbefristete Märkte
paradex_orderbook - Holen Sie sich das aktuelle Orderbuch für einen Markt mit anpassbarer Tiefe
paradex_klines - Erhalten Sie historische Candlestick-Daten (OHLCV) für einen Markt
paradex_trades - Erhalten Sie aktuelle Trades für einen Markt mit Preis-, Größen- und Zeitstempelinformationen
paradex_bbo - Holen Sie sich das beste Gebot und Angebot (engste Spanne) für einen Markt

Konto-Tools

paradex_account_summary - Kontoübersichtsinformationen abrufen
paradex_account_positions - Aktuelle Kontopositionen abrufen
paradex_account_fills - Konto-Trade-Fills abrufen
paradex_account_funding_payments – Erhalten Sie Zahlungen zur Kontofinanzierung
paradex_account_transactions - Transaktionsverlauf des Kontos abrufen

Werkzeuge bestellen

paradex_open_orders - Alle offenen Bestellungen für ein Konto abrufen
paradex_create_order - Erstellen Sie eine neue Bestellung bei Paradex
paradex_cancel_orders - Bestehende Bestellungen stornieren
paradex_order_status - Den Status einer Bestellung abrufen
paradex_orders_history - Historische Bestellungen für ein Konto abrufen

Tresor-Tools

paradex_vaults - Erhalten Sie detaillierte Informationen zu bestimmten Tresoren oder allen Tresoren mit Filteroptionen
paradex_vaults_config - Holen Sie sich die globale Konfiguration für Tresore, einschließlich Gebühren, Limits und anderen Einstellungen
paradex_vault_balance - Ruft den aktuellen Kontostand eines Tresors mit Informationen zu verfügbaren/gesperrten Geldern ab
paradex_vault_summary - Erhalten Sie eine umfassende Zusammenfassung der Tresorleistung, des Kontostands und der Aktivität
paradex_vault_transfers - Ein- und Auszahlungsverlauf für einen Tresor abrufen
paradex_vault_positions - Aktuelle Handelspositionen für einen Tresor mit Markt-, Größen- und Einstiegspreisdetails abrufen
paradex_vault_account_summary - Erhalten Sie Handelskontoinformationen für einen Tresor, einschließlich Margin- und Risikometriken

Eingabeaufforderungen zur Handelsanalyse

Dieser MCP-Server bietet strukturierte Eingabeaufforderungen, die KI-Assistenten verwenden können, um komplexe Handelsanalysen durchzuführen und Handelsstrategien zu generieren.

Marktanalyse

market_overview - Erhalten Sie einen umfassenden Überblick über den Kryptomarkt, einschließlich der größten Gewinner/Verlierer, der Märkte mit hohem Volumen, Anomalien der Finanzierungsrate und einer Analyse der Marktmikrostruktur
market_analysis – Detaillierte technische und mikrostrukturelle Analyse eines bestimmten Marktes mit Unterstützungs-/Widerstandsniveaus, Chartmustern, Orderbuchanalyse und Positionsempfehlungen

Positions- und Portfoliomanagement

position_management - Umfassende Analyse bestehender Positionen, einschließlich Portfolio-Heat, Korrelation, Risikometriken und spezifischer Empfehlungen für Gewinnmitnahmen und Verlustmanagement
create_optimal_order - Entwerfen Sie optimale Auftragsparameter für einen Markt basierend auf Volatilität, Liquidität, Risikotoleranz und idealer Einstiegsstrategie
hedging_strategy - Entwickeln Sie effektive Absicherungsstrategien für bestimmte Positionen mithilfe von Korrelationsanalysen, Hedge-Ratio-Berechnungen und Implementierungsplanungen
portfolio_risk_assessment – Gründliche Risikoanalyse des Handelsportfolios, einschließlich Exposure-Analyse, Korrelationsbewertung, VaR-Berechnungen und Empfehlungen zur Risikominderung
liquidation_protection - Identifizieren und mindern Sie Liquidationsrisiken für offene Positionen mit Schweregradklassifizierung und Schutzstrategien

Anlagestrategien

vault_analysis - Umfassende Analyse von Tresoren für Investitionsentscheidungen, mit Leistungskennzahlen, Risikoprofilen und Eignungsbewertung
funding_rate_opportunity - Identifizieren und bewerten Sie Finanzierungszinsarbitragemöglichkeiten auf allen Märkten, einschließlich Renditeberechnungen und Implementierungsstrategien
trading_consultation - Interaktive Eingabesequenz für personalisierte Handelsberatung und Beratung

Dokumentation MCP

Wir haben deutlich bessere Ergebnisse erzielt, indem wir unseren Kunden Zugriff auf die Paradex-Dokumentation gewährt haben.

"paradex-docs-mcp": {
   "command": "uvx",
   "args": [
      "--from",
      "mcpdoc",
      "mcpdoc",
      "--urls",
      "Paradex:https://docs.paradex.trade/llms.txt",
      "--transport",
      "stdio"
   ]
}

Beitragen

Informationen dazu, wie Sie zu diesem Projekt beitragen können, zur Entwicklungseinrichtung und zu unseren Codierungsstandards finden Sie in CONTRIBUTING.md .

Lizenz

MIT-Lizenz

Integrations