DexPaprika MCP Server

官方

透過 DexPaprika API 存取 20 多條區塊鏈的即時 DEX 分析資料,追蹤超過 500 萬種代幣、流動性池、交易量及歷史市場數據。由 CoinPaprika 打造。

文件

DexPaprika MCP 伺服器

一個模型上下文協定 (MCP) 伺服器,提供對 DexPaprika 加密貨幣和 DEX 資料 API 的隨需存取。專為 Claude 等 AI 助手打造,能以零設定程式化地擷取即時代幣、流動性池和 DEX 資料。

摘要

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp

DexPaprika MCP 將 Claude 連接到跨多個區塊鏈的即時 DEX 資料。無需 API 金鑰。安裝 | 設定 | API 參考

偏好零設定? 使用位於 mcp.dexpaprika.com 的託管 MCP 伺服器 — 無需安裝、無需 API 金鑰,同樣的 14 個工具。請參閱託管替代方案了解傳輸端點。

版本 1.3.0 更新重點

新工具getCapabilities(代理引導,包含工作流程、同義詞、最佳實踐)和 getNetworkPoolsFilter(伺服器端按交易量、交易次數、建立時間篩選流動性池)。

重大變更:參數重新命名為 snake_case(poolAddresspool_addresstokenAddresstoken_addressorderByorder_by)。分頁現在從 1 開始索引。完整遷移指南請參閱 CHANGELOG.md

你可以建構什麼?

  • 代幣分析工具:追蹤價格變動、流動性深度變化和交易量模式
  • DEX 比較:分析不同 DEX 的費用結構、交易量和可用流動性池
  • 流動性池分析:監控 TVL 變化、無常損失計算和價格影響評估
  • 市場分析:跨鏈代幣比較、交易量趨勢和交易活動指標
  • 投資組合追蹤器:即時價值追蹤、歷史表現分析、收益機會
  • 技術分析:使用歷史 OHLCV 資料執行進階技術分析,包括趨勢識別、形態辨識和指標計算

安裝

透過 Smithery 安裝

要透過 Smithery 為 Claude Desktop 自動安裝 DexPaprika:

npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude

手動安裝

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

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

伺服器預設在連接埠 8010 上執行。成功啟動時你會看到 MCP server is running at http://localhost:8010

影片教學

觀看我們關於設定和使用 DexPaprika MCP 伺服器的逐步教學:

DexPaprika MCP Tutorial

Claude Desktop 整合

將以下內容新增到你的 Claude Desktop 設定檔:

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 後,DexPaprika 工具將自動對 Claude 可用。

託管替代方案(無需安裝)

如果你偏好零設定,可以將任何相容 MCP 的客戶端直接指向位於 mcp.dexpaprika.com 的託管伺服器。登陸頁面提供設定說明和文件。以下傳輸端點可用:

傳輸方式端點使用案例
可串流的 HTTPhttps://mcp.dexpaprika.com/streamable-http建議大多數客戶端使用
SSEhttps://mcp.dexpaprika.com/sse舊版 SSE 傳輸
JSON-RPChttps://mcp.dexpaprika.com/mcp直接 JSON-RPC

注意:這些是 MCP 協定端點 — 它們不會在瀏覽器中顯示任何內容。請造訪 mcp.dexpaprika.com 查看登陸頁面。

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

可用工具 (14)

探索

工具描述
getCapabilities伺服器功能、工作流程模式、網路同義詞和最佳實踐。從這裡開始。
getNetworks列出所有 33 個支援的區塊鏈網路
getStats高層級生態系統統計資料(總網路數、DEX 數、流動性池數、代幣數)
search按名稱、代號或地址在所有網路上搜尋代幣、流動性池和 DEX

DEX 操作

工具描述必要參數
getNetworkDexes列出特定網路上的 DEXnetwork

流動性池操作

工具描述必要參數
getNetworkPools主要 — 取得網路上流動性最高的流動性池network
getDexPools從特定 DEX 取得流動性池networkdex
getNetworkPoolsFilter按交易量、交易次數、建立時間篩選流動性池network
getPoolDetails詳細流動性池資訊(價格、交易量、TVL、代幣)networkpool_address
getPoolOHLCV歷史 OHLCV K 線資料networkpool_addressstart
getPoolTransactions流動性池的近期交易/成交記錄networkpool_address

代幣操作

工具描述必要參數
getTokenDetails詳細代幣資訊networktoken_address
getTokenPools包含某代幣的流動性池networktoken_address
getTokenMultiPrices最多 10 個代幣的批次價格networktokens[]

使用範例

// 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 的提示範例

  • 「分析 Solana 上的 JUP 代幣。擷取價格、交易量和頂尖流動性池。」
  • 「比較以太坊上 Uniswap V3 和 SushiSwap 的交易量。」
  • 「取得 Raydium 上 SOL/USDC 的 7 天 OHLCV 資料並繪製價格圖表。」
  • 「找出 Fantom 網路上流動性前 5 名的流動性池,並分析它們的費用結構。」
  • 「取得 Uniswap 上 ETH/USDT 流動性池的近期交易,並分析買方與賣方壓力。」
  • 「顯示以太坊上 24 小時交易量前 10 名的流動性池。」
  • 「搜尋所有包含 ARB 代幣的流動性池,並按交易量排名。」
  • 「篩選以太坊上 24 小時交易量大於 $100K 且在上週建立的流動性池。」
  • 「先取得所有可用網路,然後顯示每個主要網路上頂尖的流動性池。」

速率限制與效能

  • 免費層級限制:每天 10,000 個請求
  • 回應時間:大多數端點為 100-500 毫秒(取決於網路)
  • 資料新鮮度:流動性池和代幣資料每 15-30 秒更新一次
  • 錯誤處理:結構化錯誤,包含代碼、建議和重試指引
  • OHLCV 資料可用性:歷史資料通常從代幣/流動性池建立日期起可用

疑難排解

常見問題:

  • 速率限制:如果收到 DP429_RATE_LIMIT 錯誤,請實作指數退避
  • 缺少資料:一些較新的代幣/流動性池可能有不完整的歷史資料
  • 逾時錯誤:大型資料請求可能需要更長時間,請考慮使用分頁
  • 網路錯誤:檢查網路連線,此服務需要網際網路存取
  • OHLCV 限制:開始和結束日期之間的最大範圍為 1 年;對於更長的時間範圍請使用分頁
  • 空的 OHLCV:流動性池可能太新 — 請改用 getPoolTransactions

開發

# 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

變更日誌

詳細的版本發布說明和遷移指南請參閱 CHANGELOG.md

授權

本專案採用 MIT 授權條款 - 詳情請參閱 LICENSE 檔案。

其他資源