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(poolAddress → pool_address、tokenAddress → token_address、orderBy → order_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 伺服器的逐步教學:
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 的託管伺服器。登陸頁面提供設定說明和文件。以下傳輸端點可用:
| 傳輸方式 | 端點 | 使用案例 |
|---|---|---|
| 可串流的 HTTP | https://mcp.dexpaprika.com/streamable-http | 建議大多數客戶端使用 |
| SSE | https://mcp.dexpaprika.com/sse | 舊版 SSE 傳輸 |
| JSON-RPC | https://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 | 列出特定網路上的 DEX | network |
流動性池操作
| 工具 | 描述 | 必要參數 |
|---|---|---|
getNetworkPools | 主要 — 取得網路上流動性最高的流動性池 | network |
getDexPools | 從特定 DEX 取得流動性池 | network、dex |
getNetworkPoolsFilter | 按交易量、交易次數、建立時間篩選流動性池 | network |
getPoolDetails | 詳細流動性池資訊(價格、交易量、TVL、代幣) | network、pool_address |
getPoolOHLCV | 歷史 OHLCV K 線資料 | network、pool_address、start |
getPoolTransactions | 流動性池的近期交易/成交記錄 | network、pool_address |
代幣操作
| 工具 | 描述 | 必要參數 |
|---|---|---|
getTokenDetails | 詳細代幣資訊 | network、token_address |
getTokenPools | 包含某代幣的流動性池 | network、token_address |
getTokenMultiPrices | 最多 10 個代幣的批次價格 | network、tokens[] |
使用範例
// 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 檔案。
其他資源
- DexPaprika API 文件
- 託管 MCP 伺服器 — 零設定替代方案
- 模型上下文協定規範
- DexPaprika - 全面的鏈上分析市場資料
- CoinPaprika - 全面的加密貨幣市場資料
