DexPaprika

Server MCP DexPaprika

Server Model Context Protocol (MCP) yang menyediakan akses on-demand ke API data cryptocurrency dan DEX DexPaprika. Dibangun khusus untuk asisten AI seperti Claude untuk mengambil data token, pool, dan DEX terkini secara terprogram tanpa konfigurasi apa pun.

Ringkasan

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP menghubungkan Claude dengan data DEX langsung dari berbagai blockchain. Tingkat gratis tidak memerlukan kunci API untuk memulai. Instalasi | Konfigurasi | Referensi API

Lebih suka tanpa pengaturan? Gunakan server MCP yang di-hosting di mcp.dexpaprika.com: tanpa instalasi, tanpa kunci untuk memulai, alat data yang sama plus submitFeedback. Lihat Server yang di-hosting untuk endpoint transport.

Rilis Terbaru

Lihat CHANGELOG.md untuk catatan rilis dan panduan migrasi.

Apa yang Bisa Anda Bangun?

• Alat Analisis Token: Pantau pergerakan harga, perubahan kedalaman likuiditas, dan pola volume
• Perbandingan DEX: Analisis struktur biaya, volume, dan pool yang tersedia di berbagai DEX
• Analitik Pool Likuiditas: Pantau perubahan TVL, kalkulasi kerugian impermanen, dan penilaian dampak harga
• Analisis Pasar: Perbandingan token lintas rantai, tren volume, dan metrik aktivitas perdagangan
• Pelacak Portofolio: Pelacakan nilai saat ini, analisis kinerja historis, peluang imbal hasil
• Analisis Teknis: Lakukan analisis teknis lanjutan menggunakan data OHLCV historis, termasuk identifikasi tren, pengenalan pola, dan kalkulasi indikator

Instalasi

Instalasi melalui Smithery

Untuk menginstal DexPaprika untuk Claude Desktop secara otomatis melalui Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Instalasi Manual

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

# Start the server
dexpaprika-mcp

Ini adalah server stdio: ia berbicara MCP melalui stdin dan stdout dan tidak mengikat port apa pun. Saat dimulai, ia menulis DexPaprika MCP server v<version> (tool contract v<contract>) is running... ke stderr lalu menunggu klien. Jalankan dari klien MCP (Claude Desktop, Cursor, Claude Code) daripada mengharapkan URL di browser.

Tutorial Video

Tonton tutorial langkah demi langkah kami tentang cara mengatur dan menggunakan server MCP DexPaprika:

Integrasi Claude Desktop

Tambahkan berikut ini ke file konfigurasi Claude Desktop Anda:

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

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

Setelah memulai ulang Claude Desktop, alat DexPaprika akan tersedia untuk Claude secara otomatis.

Opsional: menggunakan kunci API

Ini berfungsi tanpa kunci dan akan selalu begitu. Tanpa pendaftaran, tanpa kartu, tanpa perlu mengonfigurasi apa pun. Semua hal di atas adalah cara yang didukung untuk menjalankannya.

Kunci gratis meningkatkan kuota bulanan dan membuka streaming pada token apa pun, bukan hanya set pameran publik. Ini tidak meningkatkan batas permintaan per menit, yang sama di kedua tingkat. Dapatkan kunci di console.dexpaprika.com; batas saat ini ada di halaman batas permintaan.

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

Kunci dimasukkan apa adanya. Tidak ada prefiks Bearer, dan tidak ada kata skema lain juga. Tempel kunci persis seperti yang diterbitkan. Hampir semua API lain menginginkan kebalikannya, jadi ini adalah alasan paling umum mengapa kunci yang berfungsi terlihat rusak.

Dua hal yang perlu diketahui:

• Kunci yang tidak dapat kami baca tidak menghasilkan error. Endpoint data mengabaikan kunci yang tidak dapat dibaca dan melayani Anda sebagai pemanggil anonim, dengan 200 normal dan data asli, jadi salah ketik terlihat persis seperti sukses. Minta asisten untuk menjalankan getKeyStatus setelah mengaturnya: ia melaporkan paket mana yang sebenarnya dilihat API dan menyebutkan kemungkinan penyebabnya ketika kunci tidak masuk.
• Pelanggan Pro juga mengatur DEXPAPRIKA_API_BASE_URL menjadi https://api-pro.dexpaprika.com. Host tidak berubah secara otomatis, karena mengirim kunci gratis ke host tersebut mengembalikan 403.

Server yang di-hosting (tanpa instalasi)

Jika Anda lebih suka tanpa pengaturan, arahkan klien yang kompatibel dengan MCP mana pun langsung ke server yang di-hosting di mcp.dexpaprika.com. Halaman arahan menyediakan instruksi pengaturan dan dokumentasi. Endpoint transport berikut tersedia:

Transport	Endpoint	Kasus Penggunaan
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	Direkomendasikan untuk sebagian besar klien
SSE	https://mcp.dexpaprika.com/sse	Transport SSE lama
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC langsung

Catatan: Ini adalah endpoint protokol MCP. Mereka tidak akan menampilkan apa pun di browser. Kunjungi mcp.dexpaprika.com untuk halaman arahan.

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

Alat Tersedia (17)

Build self-host ini mendaftarkan 17 alat baca: 16 alat data pasar plus getKeyStatus. Server yang di-hosting di mcp.dexpaprika.com mendaftarkan kumpulan alatnya sendiri termasuk submitFeedback. Verifikasi keduanya dengan tools/list langsung.

Penemuan

Alat	Deskripsi
getCapabilities	Kemampuan server, pola alur kerja, sinonim jaringan, dan praktik terbaik. Mulai di sini.
getNetworks	Daftarkan setiap jaringan blockchain yang didukung (36)
getStats	Statistik ekosistem tingkat tinggi (total jaringan, DEX, pool, token)
search	Cari token, pool, dan DEX di SEMUA jaringan berdasarkan nama, simbol, atau alamat
getKeyStatus	Apakah kunci sedang dikirim dan paket mana yang dilihat API. Tidak membaca data pasar.

Operasi DEX

Alat	Deskripsi	Parameter Wajib
getNetworkDexes	Daftarkan DEX di jaringan tertentu	network

Operasi Pool

Alat	Deskripsi	Parameter Wajib
getNetworkPools	UTAMA. Dapatkan pool likuiditas teratas di jaringan	network
getDexPools	Dapatkan pool dari DEX tertentu (baris di bawah results, paginasi kursor)	network, dex
getNetworkPoolsFilter	Filter pool berdasarkan volume, transaksi, waktu pembuatan	network
getPoolDetails	Info pool terperinci (harga, volume, TVL, token)	network, pool_address
getPoolOHLCV	Data candle OHLCV historis	network, pool_address, start
getPoolTransactions	Transaksi/perdagangan terbaru untuk pool	network, pool_address

Operasi Token

Alat	Deskripsi	Parameter Wajib
getTokenDetails	Informasi token terperinci	network, token_address
getTokenPools	Pool likuiditas yang berisi token (filter terbatas jaringan, results + paginasi kursor)	network, token_address
getTokenMultiPrices	Harga dalam batch untuk hingga 10 token	network, tokens[]
getTopTokens	Token teratas di jaringan berdasarkan peringkat volume, likuiditas, FDV, atau perubahan harga 24 jam	network
filterNetworkTokens	Filter token berdasarkan volume, likuiditas, FDV, transaksi, dan waktu pembuatan	network

Contoh Penggunaan

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

Contoh Prompt untuk Claude

• "Analisis token JUP di Solana. Ambil harga, volume, dan pool likuiditas teratas."
• "Bandingkan volume perdagangan antara Uniswap V3 dan SushiSwap di Ethereum."
• "Dapatkan data OHLCV 7 hari untuk SOL/USDC di Raydium dan buat bagan harga."
• "Temukan 5 pool teratas berdasarkan likuiditas di jaringan Fantom dan analisis struktur biaya mereka."
• "Dapatkan transaksi terbaru untuk pool ETH/USDT di Uniswap dan analisis tekanan beli vs jual."
• "Tampilkan 10 pool teratas di Ethereum berdasarkan volume 24 jam."
• "Cari semua pool yang berisi token ARB dan urutkan berdasarkan volume."
• "Filter pool Ethereum dengan volume 24 jam >$100K yang dibuat dalam seminggu terakhir."
• "Pertama dapatkan semua jaringan yang tersedia, lalu tampilkan pool teratas di setiap jaringan utama."

Batas Permintaan & Kinerja

• Tingkat gratis: tanpa kunci, tanpa pendaftaran, 30 permintaan per menit. Kunci API gratis meningkatkan kuota bulanan dan membuka streaming. Pro adalah $99/bulan dengan 300 permintaan per menit. Satu permintaan memakan satu kredit; endpoint batch memakan satu kredit per item. Kuota bulanan berubah, jadi baca di sini daripada dari halaman ini: https://dexpaprika.com/api/pricing
• Penundaan data: hingga 15 detik pada tingkat gratis, real-time di Pro
• Waktu Respons: 100-500ms untuk sebagian besar endpoint (tergantung jaringan)
• Penanganan Error: Error terstruktur dengan kode, saran, dan panduan percobaan ulang
• Ketersediaan Data OHLCV: Data historis biasanya tersedia sejak tanggal pembuatan token/pool

Pemecahan Masalah

Masalah Umum:

• Pembatasan permintaan: Jika menerima error DP429_RATE_LIMIT, terapkan backoff eksponensial
• Data tidak lengkap: Beberapa token/pool baru mungkin memiliki data historis yang tidak lengkap
• Error waktu tunggu: Permintaan data besar mungkin memakan waktu lebih lama, pertimbangkan paginasi
• Error jaringan: Periksa konektivitas jaringan, layanan memerlukan akses internet
• Keterbatasan OHLCV: Rentang maksimum antara tanggal mulai dan akhir adalah 1 tahun; gunakan paginasi untuk rentang waktu yang lebih panjang
• OHLCV kosong: Pool mungkin terlalu baru. Gunakan getPoolTransactions sebagai gantinya

Pengembangan

# 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

Riwayat Perubahan

Lihat CHANGELOG.md untuk catatan rilis terperinci dan panduan migrasi.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT - lihat file LICENSE untuk detailnya.

Sumber Daya Tambahan

• Dokumentasi API DexPaprika
• Server MCP yang di-hosting, opsi tanpa pengaturan
• Spesifikasi Model Context Protocol
• DexPaprika - Data pasar analitik onchain yang komprehensif
• CoinPaprika - Data pasar cryptocurrency yang komprehensif