DexPaprika

DexPaprika MCP Sunucusu

Yapay zeka asistanları (Claude gibi) için sıfır yapılandırma ile güncel token, havuz ve DEX verilerini programatik olarak getirmek üzere tasarlanmış, DexPaprika'nın kripto para ve DEX veri API'sine isteğe bağlı erişim sağlayan bir Model Context Protocol (MCP) sunucusudur.

TL;DR

# 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. Ücretsiz katman, başlamak için API anahtarı gerektirmez. Kurulum | Yapılandırma | API Referansı

Sıfır kurulum mu tercih edersiniz? Barındırılan MCP sunucusunu mcp.dexpaprika.com adresinde kullanın: kurulum gerektirmez, başlamak için anahtar gerekmez, aynı veri araçları artı submitFeedback. Taşıma uç noktaları için Barındırılan sunucu bölümüne bakın.

Son sürüm

Sürüm notları ve geçiş rehberleri için CHANGELOG.md dosyasına bakın.

Neler Yapabilirsiniz?

• Token Analiz Araçları: Fiyat hareketlerini, likidite derinliği değişimlerini 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şimlerini, kalıcı 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: Güncel 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 üzerinden otomatik olarak kurmak için:

npx -y smithery mcp add coinpaprika/dexpaprika

Manuel Kurulum

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

# Start the server
dexpaprika-mcp

Bu bir stdio sunucusudur: MCP'yi stdin ve stdout üzerinden konuşur ve hiçbir bağlantı noktasını bağlamaz. Başlatıldığında DexPaprika MCP server v<version> (tool contract v<contract>) is running... öğesini stderr'e yazar ve ardından bir istemci bekler. Tarayıcıda bir URL beklemek yerine bir MCP istemcisinden (Claude Desktop, Cursor, Claude Code) çalıştırın.

Video Eğitimi

DexPaprika MCP sunucusunu kurma ve kullanma hakkındaki adım adım eğitimimizi izleyin:

Claude Desktop Entegrasyonu

Claude Desktop yapılandırma dosyanıza aşağıdakileri 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.

İsteğe bağlı: API anahtarı kullanımı

Bu, anahtar olmadan da çalışır ve her zaman çalışacaktır. Kayıt yok, kart yok, yapılandırılacak bir şey yok. Yukarıdaki her şey, çalıştırmanın desteklenen yoludur.

Ücretsiz bir anahtar, aylık kotayı yükseltir ve herhangi bir token üzerinde yayın akışını açar (genel vitrin kümesi yerine). Dakikada istek sınırını yükseltmez; bu sınır her iki katmanda da aynıdır. console.dexpaprika.com adresinden bir anahtar edinin; güncel limitler hız sınırları sayfasında yer alır.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

Anahtar kendi başına gider. Bearer ön eki yoktur ve başka bir şema sözcüğü de yoktur. Anahtarı tam olarak verildiği gibi yapıştırın. Neredeyse diğer her API tersini ister, bu yüzden çalışan bir anahtarın bozuk görünmesinin en yaygın nedeni budur.

Bilmeniz gereken iki şey:

• Okuyamadığımız bir anahtar hata üretmez. Veri uç noktaları, okunamayan bir anahtarı yok sayar ve sizi normal bir 200 ve gerçek verilerle anonim bir arayan olarak sunar; bu nedenle bir yazım hatası tam olarak başarı gibi görünür. Bir anahtar ayarladıktan sonra asistandan getKeyStatus çalıştırmasını isteyin: API'nin gerçekte hangi planı gördüğünü raporlar ve anahtar ulaşmadığında olası nedeni adlandırır.
• Pro müşterileri ayrıca DEXPAPRIKA_API_BASE_URL öğesini https://api-pro.dexpaprika.com olarak ayarlar. Ana bilgisayar otomatik olarak değişmez; çünkü ücretsiz bir anahtarı bu ana bilgisayara göndermek 403 döndürür.

Barındırılan sunucu (kurulum gerektirmez)

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

Taşıma	Uç Nokta	Kullanım Durumu
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	Çoğu istemci için önerilir
SSE	https://mcp.dexpaprika.com/sse	Eski SSE taşıması
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	Doğrudan JSON-RPC

Not: Bunlar MCP protokol uç noktalarıdır. 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"
    }
  }
}

Kullanılabilir Araçlar (17)

Bu kendi kendine barındırılan yapı 17 salt-okunur araç kaydeder: 16 piyasa veri aracı artı getKeyStatus. mcp.dexpaprika.com adresindeki barındırılan sunucu, submitFeedback dahil kendi setini kaydeder. Herhangi birini canlı tools/list ile doğrulayın.

Keşif

Araç	Açıklama
getCapabilities	Sunucu yetenekleri, iş akışı desenleri, 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, tokenler)
search	TÜM ağlarda tokenları, havuzları ve DEX'leri ada, sembole veya adrese göre ara
getKeyStatus	Bir anahtarın gönderilip gönderilmediği ve API'nin hangi planı gördüğü. Piyasa verisi okumaz.

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 yüksek likidite havuzlarını al	network
getDexPools	Belirli bir DEX'ten havuzları al (results altındaki satırlar, imleç sayfalama)	network, dex
getNetworkPoolsFilter	Havuzları hacme, işlemlere, oluşturma zamanına göre filtrele	network
getPoolDetails	Ayrıntılı havuz bilgisi (fiyat, hacim, TVL, tokenler)	network, pool_address
getPoolOHLCV	Geçmiş OHLCV mum verileri	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	Ayrıntılı token bilgisi	network, token_address
getTokenPools	Bir token içeren likidite havuzları (ağ kapsamlı filtre, results + imleç sayfalama)	network, token_address
getTokenMultiPrices	En fazla 10 token için toplu fiyatlar	network, tokens[]
getTopTokens	Bir ağdaki en yüksek tokenlar, hacim, likidite, FDV veya 24 saatlik fiyat değişimine göre sıralanmış	network
filterNetworkTokens	Tokenları hacme, likiditeye, FDV'ye, işlemlere ve oluşturma zamanına göre filtrele	network

Ö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 tokenini analiz et. Fiyat, hacim ve en yüksek 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 verilerini al ve bir fiyat grafiği çiz."
• "Fantom ağındaki likiditeye göre en yüksek 5 havuzu bul ve ücret yapılarını analiz et."
• "Uniswap'teki ETH/USDT havuzu için son işlemleri al ve alım vs satım baskısını analiz et."
• "Ethereum'daki 24 saatlik hacme göre en yüksek 10 havuzu göster."
• "ARB tokenini içeren tüm havuzları ara ve hacme göre sırala."
• "Ethereum havuzlarını >$100K 24 saatlik hacimle, son haftada oluşturulmuş olarak filtrele."
• "Önce mevcut tüm ağları al, ardından her ana ağdaki en yüksek havuzları göster."

Hız Sınırları ve Performans

• Ücretsiz katman: anahtarsız, kayıt gerektirmez, dakikada 30 istek. Ücretsiz bir API anahtarı aylık kotayı yükseltir ve akışı açar. Pro, dakikada 300 istek için ayda 99$'dır. Bir istek bir kredi maliyetindedir; toplu uç noktalar öğe başına bir kredi maliyetindedir. Aylık kotalar değişir, bu yüzden bu sayfadan değil, şuradan okuyun: https://dexpaprika.com/api/pricing
• Veri gecikmesi: ücretsiz katmanda en fazla 15 saniye, Pro'da gerçek zamanlı
• Yanıt Süresi: çoğu uç nokta için 100-500ms (ağa bağlı)
• 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şturma tarihinden itibaren mevcuttur

Sorun Giderme

Yaygın Sorunlar:

• Hız sınırlama: DP429_RATE_LIMIT hataları alıyorsanız, üstel geri çekilme uygulayın
• Eksik veri: Bazı yeni tokenler/havuzlar eksik geçmiş verilere sahip olabilir
• Zaman aşımı hataları: Büyük veri istekleri daha uzun sürebilir, sayfalama yapmayı 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ş rehberleri 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

• DexPaprika API Dokümantasyonu
• Barındırılan MCP Sunucusu, sıfır kurulum seçeneği
• Model Context Protocol Spesifikasyonu
• DexPaprika - Kapsamlı zincir üstü analitik piyasa verisi
• CoinPaprika - Kapsamlı kripto para piyasa verisi