DexPaprika

DexPaprika MCP Sunucusu

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

Özet

# 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? mcp.dexpaprika.com adresindeki barındırılan MCP sunucusunu kullanın: kurulum yok, başlamak için anahtar yok, aynı veri araçları artı submitFeedback. Aktarım 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ş kılavuzları için CHANGELOG.md dosyasına bakın.

Neler Oluşturabilirsiniz?

• Token Analiz Araçları: Fiyat hareketlerini, likidite derinliği değişimlerini 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ş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 tanımlama, desen tanıma ve gösterge hesaplamaları dahil olmak üzere geçmiş OHLCV verilerini kullanarak ileri düzey 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ı bağlamaz. Başlangıçta DexPaprika MCP server v<version> (tool contract v<contract>) is running... öğesini stderr'e yazar ve ardından bir istemci bekler. Bir tarayıcıda 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 için otomatik olarak kullanılabilir olacaktır.

İsteğe bağlı: API anahtarı kullanma

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

Ücretsiz bir anahtar aylık kotayı yükseltir ve genel tanıtım seti yerine herhangi bir token üzerinde akışı açar. Dakika başına istek sınırını yükseltmez; bu sınır her iki katmanda da aynıdır. Bir tane almak için console.dexpaprika.com adresini ziyaret edin; güncel sınırlar 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 öneki yoktur ve başka bir şema sözcüğü de yoktur. Anahtarı tam olarak verildiği gibi yapıştırın. Neredeyse diğer tüm API'ler tam tersini ister, bu yüzden bu, çalışan bir anahtarın bozuk görünmesinin en yaygın tek nedenidir.

Bilmeye değer iki şey:

• Okuyamadığımız bir anahtar hata üretmez. Veri uç noktaları okunamayan bir anahtarı yok sayar ve size normal bir 200 ve gerçek verilerle anonim bir arayan olarak hizmet verir, 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ü bildirir ve anahtar yerleşmediğinde olası nedeni adlandırır.
• Pro müşteriler 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 yok)

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 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/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 derleme 17 okuma aracı kaydeder: 16 piyasa verisi aracı artı getKeyStatus. mcp.dexpaprika.com adresindeki barındırılan sunucu, submitFeedback dahil kendi setini kaydeder. Her ikisini de canlı bir 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 her blok zinciri ağını listeleyin (36)
getStats	Üst düzey ekosistem istatistikleri (toplam ağlar, DEX'ler, havuzlar, tokenler)
search	TÜM ağlarda tokenleri, havuzları ve DEX'leri ada, sembole veya adrese göre arayın
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 listeleyin	network

Havuz İşlemleri

Araç	Açıklama	Gerekli Parametreler
getNetworkPools	BİRİNCİL. Bir ağdaki en iyi likidite havuzlarını alın	network
getDexPools	Belirli bir DEX'ten havuzları alın (results altındaki satırlar, imleç sayfalama)	network, dex
getNetworkPoolsFilter	Havuzları hacme, işlemlere, oluşturma zamanına göre filtreleyin	network
getPoolDetails	Ayrıntılı havuz bilgileri (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 bilgileri	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ğda hacme, likiditeye, FDV'ye veya 24 saatlik fiyat değişimine göre sıralanan en iyi tokenler	network
filterNetworkTokens	Tokenleri hacme, likiditeye, FDV'ye, işlemlere ve oluşturma zamanına göre filtreleyin	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: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

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

Claude için Örnek Komutlar

• "Solana'daki JUP tokenini analiz edin. Fiyatı, hacmi ve en iyi likidite havuzlarını getirin."
• "Ethereum'da Uniswap V3 ile SushiSwap arasındaki işlem hacmini karşılaştırın."
• "Raydium'da SOL/USDC için son günün saatlik OHLCV verilerini alın ve bir fiyat grafiği çizin."
• "Fantom ağında likiditeye göre en iyi 5 havuzu bulun ve ücret yapılarını analiz edin."
• "Uniswap'teki ETH/USDT havuzu için son işlemleri alın ve alım vs satım baskısını analiz edin."
• "Ethereum'da 24 saatlik hacme göre en iyi 10 havuzu gösterin."
• "ARB tokenini içeren tüm havuzları arayın ve hacme göre sıralayın."
• "Geçen hafta oluşturulan >100.000$ 24 saatlik hacme sahip Ethereum havuzlarını filtreleyin."
• "Önce mevcut tüm ağları alın, ardından her büyük ağdaki en iyi havuzları gösterin."

Hız Sınırları ve Performans

• Ücretsiz katman: anahtarsız, kayıt yok, dakikada 15 istek. Ücretsiz bir API anahtarı bunu dakikada 30 isteğe yükseltir, aylık kotayı yükseltir ve akışın kilidini açar: https://console.dexpaprika.com. adresinden kaydolun. Pro, dakikada 500 istek için ayda 99$'dır ve 120 için 30$'lık bir Dev planı vardır. Bir istek bir krediye mal olur; toplu uç noktalar öğe başına bir krediye mal olur. Tam belgeler https://docs.dexpaprika.com. adresindedir. Aylık kotalar değişir, bu nedenle bu sayfadan değil buradan okuyun: https://dexpaprika.com/api/pricing
• Veri gecikmesi: ücretsiz katmanda 60 saniyeye kadar, ücretli planlarda 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ı: Bir istek en fazla 1000 mum döndürür (limit); daha uzun bir süre için start öğesini ileri taşıyın ve tekrar isteyin. Anahtar olmadan OHLCV son 24 saati 1h ve daha uzun süreyi (start: "-24h") kapsar; ücretsiz bir anahtar 10m ve daha uzun süreyle 7 gün açar. Plana göre OHLCV sınırlarına bakı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 LISANS dosyasına bakın.

Ek Kaynaklar

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