DexPaprika MCP Server
resmiDexPaprika 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ı (poolAddress → pool_address, tokenAddress → token_address, orderBy → order_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:
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şıma | 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 taşıması |
| 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ö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 |
|---|---|
getCapabilities | Sunucu yetenekleri, iş akışı desenleri, ağ eş anlamlıları ve en iyi uygulamalar. Buradan başlayın. |
getNetworks | Desteklenen 33 blok zinciri ağının tümünü listeler |
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 arayın |
DEX İşlemleri
| Araç | Açıklama | Gerekli Parametreler |
|---|---|---|
getNetworkDexes | Belirli bir ağdaki DEX'leri listeler | network |
Havuz İşlemleri
| Araç | Açıklama | Gerekli Parametreler |
|---|---|---|
getNetworkPools | BİRİNCİL — Bir ağdaki en iyi likidite havuzlarını getirir | network |
getDexPools | Belirli bir DEX'ten havuzları getirir | network, dex |
getNetworkPoolsFilter | Havuzları hacim, işlem, oluşturulma zamanına göre filtreler | network |
getPoolDetails | Ayrıntılı 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/takaslar | 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ı | network, token_address |
getTokenMultiPrices | En fazla 10 token için toplu fiyatlar | network, 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_LIMIThataları 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
getPoolTransactionskullanı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
- 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
