DexPaprika MCP Server

offiziell

Access real-time DEX analytics across 20+ blockchains with DexPaprika API, tracking 5M+ tokens, pools, volumes, and historical market data. Built by CoinPaprika.

Dokumentation

DexPaprika MCP Server

Ein Model Context Protocol (MCP) Server, der On-Demand-Zugriff auf die Kryptowährungs- und DEX-Daten-API von DexPaprika bietet. Speziell für KI-Assistenten wie Claude entwickelt, um programmgesteuert Echtzeit-Token-, Pool- und DEX-Daten ohne Konfiguration abzurufen.

TL;DR

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp

DexPaprika MCP verbindet Claude mit Live-DEX-Daten über mehrere Blockchains hinweg. Keine API-Schlüssel erforderlich. Installation | Konfiguration | API-Referenz

Bevorzugen Sie Zero Setup? Nutzen Sie den gehosteten MCP-Server unter mcp.dexpaprika.com — keine Installation, kein API-Schlüssel, dieselben 14 Tools. Siehe Gehostete Alternative für Transport-Endpunkte.

Highlights der Version 1.3.0

Neue Tools: getCapabilities (Agent-Onboarding mit Workflows, Synonymen, Best Practices) und getNetworkPoolsFilter (serverseitige Pool-Filterung nach Volumen, Transaktionen, Erstellungszeit).

Breaking: Parameter wurden in snake_case umbenannt (poolAddresspool_address, tokenAddresstoken_address, orderByorder_by). Die Paginierung ist jetzt 1-indiziert. Siehe CHANGELOG.md für eine vollständige Migrationsanleitung.

Was können Sie bauen?

  • Token-Analyse-Tools: Preisbewegungen, Liquiditätstiefenänderungen und Volumenmuster verfolgen
  • DEX-Vergleiche: Gebührenstrukturen, Volumen und verfügbare Pools über verschiedene DEXes hinweg analysieren
  • Liquiditätspool-Analysen: TVL-Änderungen überwachen, Berechnungen des impermanenten Verlusts und Preisauswirkungsbewertungen
  • Marktanalyse: Chain-übergreifende Token-Vergleiche, Volumentrends und Handelsaktivitätsmetriken
  • Portfolio-Tracker: Echtzeit-Wertverfolgung, historische Performance-Analyse, Renditechancen
  • Technische Analyse: Fortgeschrittene technische Analyse mit historischen OHLCV-Daten, einschließlich Trenderkennung, Mustererkennung und Indikatorberechnungen

Installation

Installation über Smithery

Um DexPaprika für Claude Desktop automatisch über Smithery zu installieren:

npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude

Manuelle Installation

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

Der Server läuft standardmäßig auf Port 8010. Bei erfolgreichem Start sehen Sie MCP server is running at http://localhost:8010.

Video-Tutorial

Sehen Sie sich unser Schritt-für-Schritt-Tutorial zur Einrichtung und Nutzung des DexPaprika MCP-Servers an:

DexPaprika MCP Tutorial

Claude Desktop Integration

Fügen Sie Folgendes zu Ihrer Claude Desktop Konfigurationsdatei hinzu:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp"]
    }
  }
}

Nach dem Neustart von Claude Desktop stehen die DexPaprika-Tools Claude automatisch zur Verfügung.

Gehostete Alternative (Keine Installation)

Wenn Sie Zero Setup bevorzugen, verbinden Sie jeden MCP-kompatiblen Client direkt mit dem gehosteten Server unter mcp.dexpaprika.com. Die Landingpage bietet Einrichtungsanweisungen und Dokumentation. Die folgenden Transport-Endpunkte sind verfügbar:

TransportEndpunktAnwendungsfall
Streamable HTTPhttps://mcp.dexpaprika.com/streamable-httpEmpfohlen für die meisten Clients
SSEhttps://mcp.dexpaprika.com/sseLegacy SSE Transport
JSON-RPChttps://mcp.dexpaprika.com/mcpDirektes JSON-RPC

Hinweis: Dies sind MCP-Protokoll-Endpunkte — sie zeigen in einem Browser nichts an. Besuchen Sie mcp.dexpaprika.com für die Landingpage.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Verfügbare Tools (14)

Erkundung

ToolBeschreibung
getCapabilitiesServer-Fähigkeiten, Workflow-Muster, Netzwerk-Synonyme und Best Practices. Hier starten.
getNetworksAlle 33 unterstützten Blockchain-Netzwerke auflisten
getStatsÜbergeordnete Ökosystem-Statistiken (Gesamtnetzwerke, DEXes, Pools, Token)
searchToken, Pools und DEXes über ALLE Netzwerke hinweg nach Name, Symbol oder Adresse durchsuchen

DEX-Operationen

ToolBeschreibungErforderliche Parameter
getNetworkDexesDEXes in einem bestimmten Netzwerk auflistennetwork

Pool-Operationen

ToolBeschreibungErforderliche Parameter
getNetworkPoolsPRIMÄR — Top-Liquiditätspools in einem Netzwerk abrufennetwork
getDexPoolsPools von einem bestimmten DEX abrufennetwork, dex
getNetworkPoolsFilterPools nach Volumen, Transaktionen, Erstellungszeit filternnetwork
getPoolDetailsDetaillierte Pool-Informationen (Preis, Volumen, TVL, Token)network, pool_address
getPoolOHLCVHistorische OHLCV-Kerzendatennetwork, pool_address, start
getPoolTransactionsAktuelle Transaktionen/Trades für einen Poolnetwork, pool_address

Token-Operationen

ToolBeschreibungErforderliche Parameter
getTokenDetailsDetaillierte Token-Informationennetwork, token_address
getTokenPoolsLiquiditätspools, die einen Token enthaltennetwork, token_address
getTokenMultiPricesGestaffelte Preise für bis zu 10 Tokennetwork, tokens[]

Beispielnutzung

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find all pools for a specific token with volume sorting:
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd",
  limit: 5
});

// Get top pools on Ethereum:
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: 1710806400,
  sort_by: "volume_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "2023-01-01",
  interval: "24h",
  limit: 30
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Beispiel-Prompts für Claude

  • "Analysiere den JUP-Token auf Solana. Rufe Preis, Volumen und Top-Liquiditätspools ab."
  • "Vergleiche das Handelsvolumen zwischen Uniswap V3 und SushiSwap auf Ethereum."
  • "Hole die 7-Tage-OHLCV-Daten für SOL/USDC auf Raydium und zeichne einen Preis-Chart."
  • "Finde die Top-5-Pools nach Liquidität im Fantom-Netzwerk und analysiere ihre Gebührenstrukturen."
  • "Hole die letzten Transaktionen für den ETH/USDT-Pool auf Uniswap und analysiere Kauf- vs. Verkaufsdruck."
  • "Zeige mir die Top-10-Pools auf Ethereum nach 24-Stunden-Volumen."
  • "Suche nach allen Pools, die den ARB-Token enthalten, und ordne sie nach Volumen."
  • "Filtere Ethereum-Pools mit >100.000 $ 24-Stunden-Volumen, die in der letzten Woche erstellt wurden."
  • "Hole zuerst alle verfügbaren Netzwerke und zeige mir dann die Top-Pools in jedem großen Netzwerk."

Ratenlimits & Leistung

  • Free-Tier-Limits: 10.000 Anfragen pro Tag
  • Antwortzeit: 100-500 ms für die meisten Endpunkte (netzwerkabhängig)
  • Datenaktualität: Pool- und Token-Daten werden alle 15-30 s aktualisiert
  • Fehlerbehandlung: Strukturierte Fehler mit Codes, Vorschlägen und Wiederholungsanleitung
  • OHLCV-Datenverfügbarkeit: Historische Daten sind in der Regel ab dem Erstellungsdatum des Tokens/Pools verfügbar

Fehlerbehebung

Häufige Probleme:

  • Ratenlimitierung: Wenn Sie DP429_RATE_LIMIT-Fehler erhalten, implementieren Sie exponentielles Backoff
  • Fehlende Daten: Einige neuere Token/Pools können unvollständige historische Daten haben
  • Timeout-Fehler: Große Datenanfragen können länger dauern, erwägen Sie Paginierung
  • Netzwerkfehler: Überprüfen Sie die Netzwerkkonnektivität, der Dienst benötigt Internetzugang
  • OHLCV-Einschränkungen: Der maximale Bereich zwischen Start- und Enddatum beträgt 1 Jahr; verwenden Sie Paginierung für längere Zeiträume
  • Leeres OHLCV: Der Pool könnte zu neu sein — verwenden Sie stattdessen getPoolTransactions

Entwicklung

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

Changelog

Siehe CHANGELOG.md für detaillierte Versionshinweise und Migrationsanleitungen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert — siehe die LICENSE-Datei für Details.

Zusätzliche Ressourcen