DexPaprika MCP Server

resmi

DexPaprika API ile 20'den fazla blok zincirinde gerçek zamanlı DEX analizlerine erişin, 5 milyondan fazla token, havuz, hacim ve geçmiş piyasa verilerini takip edin. CoinPaprika tarafından oluşturulmuştur.

Dokümantasyon

DexPaprika MCP Sunucusu

Bir Model Bağlam Protokolü (MCP) sunucusu olup, DexPaprika'nın kripto para ve DEX veri API'sine isteğe bağlı erişim sağlar. Özellikle Claude gibi yapay zeka asistanlarının, sıfır yapılandırma ile gerçek zamanlı token, havuz ve DEX verilerini programatik olarak alması için geliştirilmiştir.

Kısaca

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp

DexPaprika MCP, Claude'u birden çok blok zincirindeki canlı DEX verilerine bağlar. API anahtarı gerekmez. Kurulum | Yapılandırma | API Referansı

Sıfır kurulum mu tercih edersiniz? mcp.dexpaprika.com adresindeki barındırılan MCP sunucusunu kullanın — kurulum yok, API anahtarı yok, aynı 14 araç. Taşıma uç noktaları için Barındırılan Alternatif bölümüne bakın.

Sürüm 1.3.0 Güncelleme Öne Çıkanlar

Yeni araçlar: getCapabilities (iş akışları, eş anlamlılar, en iyi uygulamalar ile aracı alıştırma) ve getNetworkPoolsFilter (hacim, işlem, oluşturulma zamanına göre sunucu tarafı havuz filtreleme).

Kırılım: Parametreler snake_case olarak yeniden adlandırıldı (poolAddresspool_address, tokenAddresstoken_address, orderByorder_by). Sayfalama artık 1-tabanlı. Tam geçiş kılavuzu için CHANGELOG.md dosyasına bakın.

Neler Geliştirebilirsiniz?

  • Token Analiz Araçları: Fiyat hareketlerini, likidite derinliği değişikliklerini ve hacim desenlerini takip edin
  • DEX Karşılaştırmaları: Farklı DEX'lerdeki ücret yapılarını, hacmi ve mevcut havuzları analiz edin
  • Likidite Havuzu Analitiği: TVL değişikliklerini, geçici kayıp hesaplamalarını ve fiyat etkisi değerlendirmelerini izleyin
  • Piyasa Analizi: Zincirler arası token karşılaştırmaları, hacim trendleri ve işlem aktivitesi metrikleri
  • Portföy Takipçileri: Gerçek zamanlı değer takibi, geçmiş performans analizi, getiri fırsatları
  • Teknik Analiz: Trend belirleme, desen tanıma ve gösterge hesaplamaları dahil olmak üzere geçmiş OHLCV verilerini kullanarak gelişmiş teknik analiz gerçekleştirin

Kurulum

Smithery ile Kurulum

DexPaprika'yı Claude Desktop için Smithery aracılığıyla otomatik olarak kurmak için:

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

Manuel Kurulum

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

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

Sunucu varsayılan olarak 8010 portunda çalışır. Başarıyla başlatıldığında MCP server is running at http://localhost:8010 ifadesini göreceksiniz.

Video Eğitimi

DexPaprika MCP sunucusunun kurulumu ve kullanımıyla ilgili adım adım eğitimimizi izleyin:

DexPaprika MCP Tutorial

Claude Desktop Entegrasyonu

Claude Desktop yapılandırma dosyanıza aşağıdakini ekleyin:

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

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

Claude Desktop'ı yeniden başlattıktan sonra, DexPaprika araçları Claude tarafından otomatik olarak kullanılabilir olacaktır.

Barındırılan Alternatif (Kurulum Gerekmez)

Sıfır kurulum tercih ederseniz, herhangi bir MCP uyumlu istemciyi doğrudan mcp.dexpaprika.com adresindeki barındırılan sunucuya yönlendirin. Açılış sayfası kurulum talimatları ve dokümantasyon sağlar. Aşağıdaki taşıma uç noktaları mevcuttur:

TaşımaUç NoktaKullanım Durumu
Akışkan HTTPhttps://mcp.dexpaprika.com/streamable-httpÇoğu istemci için önerilir
SSEhttps://mcp.dexpaprika.com/sseEski SSE taşıması
JSON-RPChttps://mcp.dexpaprika.com/mcpDoğrudan JSON-RPC

Not: Bunlar MCP protokol uç noktalarıdır — bir tarayıcıda hiçbir şey görüntülemezler. Açılış sayfası için mcp.dexpaprika.com adresini ziyaret edin.

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

Mevcut Araçlar (14)

Keşif

AraçAçıklama
getCapabilitiesSunucu yetenekleri, iş akışı desenleri, ağ eş anlamlıları ve en iyi uygulamalar. Buradan başlayın.
getNetworksDesteklenen 33 blok zinciri ağının tümünü listeler
getStatsÜst düzey ekosistem istatistikleri (toplam ağlar, DEX'ler, havuzlar, tokenlar)
searchTÜM ağlarda ada, sembole veya adrese göre token, havuz ve DEX arayın

DEX İşlemleri

AraçAçıklamaGerekli Parametreler
getNetworkDexesBelirli bir ağdaki DEX'leri listelernetwork

Havuz İşlemleri

AraçAçıklamaGerekli Parametreler
getNetworkPoolsBİRİNCİL — Bir ağdaki en iyi likidite havuzlarını getirirnetwork
getDexPoolsBelirli bir DEX'ten havuzları getirirnetwork, dex
getNetworkPoolsFilterHavuzları hacim, işlem, oluşturulma zamanına göre filtrelernetwork
getPoolDetailsAyrıntılı havuz bilgisi (fiyat, hacim, TVL, tokenlar)network, pool_address
getPoolOHLCVGeçmiş OHLCV mum verisinetwork, pool_address, start
getPoolTransactionsBir havuz için son işlemler/takaslarnetwork, pool_address

Token İşlemleri

AraçAçıklamaGerekli Parametreler
getTokenDetailsAyrıntılı token bilgisinetwork, token_address
getTokenPoolsBir token içeren likidite havuzlarınetwork, token_address
getTokenMultiPricesEn fazla 10 token için toplu fiyatlarnetwork, tokens[]

Örnek Kullanım

// 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"
  ]
});

Claude için Örnek İstemler

  • "Solana'daki JUP tokenını analiz et. Fiyat, hacim ve en iyi likidite havuzlarını getir."
  • "Ethereum'da Uniswap V3 ve SushiSwap arasındaki işlem hacmini karşılaştır."
  • "Raydium'daki SOL/USDC için 7 günlük OHLCV verisini al ve bir fiyat grafiği çiz."
  • "Fantom ağındaki likiditeye göre en iyi 5 havuzu bul ve ücret yapılarını analiz et."
  • "Uniswap'taki ETH/USDT havuzu için son işlemleri al ve alış vs satış baskısını analiz et."
  • "Ethereum'daki 24 saatlik hacme göre en iyi 10 havuzu göster."
  • "ARB tokenını içeren tüm havuzları ara ve hacme göre sırala."
  • "Son haftada oluşturulmuş, 24 saatlik hacmi >100 bin dolar olan Ethereum havuzlarını filtrele."
  • "Önce tüm mevcut ağları getir, sonra her ana ağdaki en iyi havuzları göster."

Hız Sınırları ve Performans

  • Ücretsiz Katman Sınırları: Günde 10.000 istek
  • Yanıt Süresi: Çoğu uç nokta için 100-500ms (ağa bağlı)
  • Veri Tazeliği: Havuz ve token verileri her 15-30 saniyede bir güncellenir
  • Hata Yönetimi: Kodlar, öneriler ve yeniden deneme rehberliği ile yapılandırılmış hatalar
  • OHLCV Veri Kullanılabilirliği: Geçmiş veriler genellikle token/havuz oluşturulma tarihinden itibaren mevcuttur

Sorun Giderme

Yaygın Sorunlar:

  • Hız sınırlaması: DP429_RATE_LIMIT hataları alıyorsanız, üstel geri çekilme uygulayın
  • Eksik veri: Bazı yeni tokenlar/havuzlar eksik geçmiş verilere sahip olabilir
  • Zaman aşımı hataları: Büyük veri istekleri daha uzun sürebilir, sayfalamayı düşünün
  • Ağ hataları: Ağ bağlantısını kontrol edin, hizmet internet erişimi gerektirir
  • OHLCV sınırlamaları: Başlangıç ve bitiş tarihleri arasındaki maksimum aralık 1 yıldır; daha uzun zaman dilimleri için sayfalama kullanın
  • Boş OHLCV: Havuz çok yeni olabilir — bunun yerine getPoolTransactions kullanın

Geliştirme

# 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

Değişiklik Günlüğü

Ayrıntılı sürüm notları ve geçiş kılavuzları için CHANGELOG.md dosyasına bakın.

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır — ayrıntılar için LICENSE dosyasına bakın.

Ek Kaynaklar