DexPaprika

DexPaprika MCP Sunucusu

Yapay zeka asistanlarının (Claude gibi) gerçek zamanlı token, havuz ve DEX verilerini sıfır yapılandırma ile programatik olarak alması için özel olarak oluşturulmuş, DexPaprika'nın kripto para ve DEX veri API'sine isteğe bağlı erişim sağlayan bir Model Bağlam Protokolü (MCP) sunucusu.

Kısaca

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP, Claude'u birden fazla 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ı 17 araç. Aktarım 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ı katılımı) ve getNetworkPoolsFilter (hacim, işlemler, oluşturulma zamanına göre sunucu tarafı havuz filtreleme).

Bozucu: Parametreler snake_case olarak yeniden adlandırıldı (poolAddress → pool_address, tokenAddress → token_address, orderBy → order_by). Sayfalama artık 1 indeksli. Tam geçiş kılavuzu için CHANGELOG.md dosyasına bakın.

Neler Oluşturabilirsiniz?

• Token Analiz Araçları: Fiyat hareketlerini, likidite derinliği değişikliklerini ve hacim modellerini 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 alım satım aktivitesi metrikleri
• Portföy Takipçileri: Gerçek zamanlı değer takibi, geçmiş performans analizi, getiri fırsatları
• Teknik Analiz: Trend tanımlama, formasyon 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

Smithery aracılığıyla Claude Desktop için DexPaprika'yı 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:

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@latest"]
    }
  }
}

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 aktarım uç noktaları mevcuttur:

Aktarım	Uç Nokta	Kullanım Durumu
Akışkan HTTP	https://mcp.dexpaprika.com/streamable-http	Çoğu istemci için önerilir
SSE	https://mcp.dexpaprika.com/sse	Eski SSE aktarımı
JSON-RPC	https://mcp.dexpaprika.com/mcp	Doğrudan JSON-RPC

Not: Bunlar MCP protokol uç noktalarıdır — bir tarayıcıda hiçbir şey göstermezler. 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 (17)

Keşif

Araç	Açıklama
getCapabilities	Sunucu yetenekleri, iş akışı modelleri, ağ eş anlamlıları ve en iyi uygulamalar. Buradan başlayın.
getNetworks	Desteklenen tüm blok zinciri ağlarını listele (36+)
getStats	Üst düzey ekosistem istatistikleri (toplam ağlar, DEX'ler, havuzlar, tokenlar)
search	TÜM ağlarda ada, sembole veya adrese göre token, havuz ve DEX ara

DEX İşlemleri

Araç	Açıklama	Gerekli Parametreler
getNetworkDexes	Belirli bir ağdaki DEX'leri listele	network

Havuz İşlemleri

Araç	Açıklama	Gerekli Parametreler
getNetworkPools	BİRİNCİL — Bir ağdaki en iyi likidite havuzlarını al	network
getDexPools	Belirli bir DEX'ten havuzları al	network, dex
getNetworkPoolsFilter	Havuzları hacme, işlemlere, oluşturulma zamanına göre filtrele	network
getPoolDetails	Detaylı havuz bilgisi (fiyat, hacim, TVL, tokenlar)	network, pool_address
getPoolOHLCV	Geçmiş OHLCV mum verisi	network, pool_address, start
getPoolTransactions	Bir havuz için son işlemler/alım satımlar	network, pool_address

Token İşlemleri

Araç	Açıklama	Gerekli Parametreler
getTokenDetails	Detaylı token bilgisi	network, token_address
getTokenPools	Bir token içeren likidite havuzları (ağ kapsamlı filtre, results + imleç sayfalama)	network, token_address
getTokenMultiPrices	10'a kadar token için toplu fiyatlar	network, tokens[]
getTopTokens	Hacim, likidite, FDV veya 24s fiyat değişimine göre sıralanmış bir ağdaki en iyi tokenlar	network
filterNetworkTokens	Tokenları hacim, likidite, FDV, işlemler ve oluşturulma zamanına göre filtrele	network

Geri Bildirim

Araç	Açıklama	Gerekli Parametreler
submitFeedback	Beklenmeyen araç davranışını, eksik veriyi veya dokümantasyon boşluklarını doğrudan ekibe bildir	goal

Ö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 pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  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_usd_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 alım satım hacmini karşılaştır."
• "Raydium'da SOL/USDC için 7 günlük OHLCV verisini al ve bir fiyat grafiği çiz."
• "Fantom ağında 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ış ile satış baskısını analiz et."
• "Bana Ethereum'daki 24s 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 hafta oluşturulmuş, 24s hacmi >100.000$ olan Ethereum havuzlarını filtrele."
• "Önce tüm mevcut ağları al, sonra bana her büyük ağdaki en iyi havuzları göster."

Hız Limitleri ve Performans

• Ücretsiz Katman Limitleri: Günlük 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, servis 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üğü

Detaylı 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 - detaylar için LICENSE dosyasına bakın.

Ek Kaynaklar

• DexPaprika API Dokümantasyonu
• Barındırılan MCP Sunucusu — Sıfır kurulum alternatifi
• Model Bağlam Protokolü Spesifikasyonu
• DexPaprika - Kapsamlı zincir üstü analitik piyasa verisi
• CoinPaprika - Kapsamlı kripto para piyasa verisi