DexPaprika MCP 服务器

一个按需提供 DexPaprika 加密货币和去中心化交易所数据 API 访问的模型上下文协议（MCP）服务器。专为 Claude 等 AI 助手构建，无需配置即可编程获取实时代币、流动池和 DEX 数据。

快速开始

# 全局安装
npm install -g dexpaprika-mcp

# 启动服务器
dexpaprika-mcp

# 或直接运行（无需安装）
npx dexpaprika-mcp

DexPaprika MCP 让 Claude 能跨多条区块链获取实时 DEX 数据，无需 API 密钥。安装指南 | 配置说明 | API 文档

🚨 版本 1.2.0 更新亮点

新增：批量代币价格工具 getTokenMultiPrices 和增强版 getNetworkDexes 参数。参见下方示例。

🚨 版本 1.1.0 重要通知

重大变更：全局 /pools 端点已被移除。若从 v1.0.x 升级，请参阅下方的迁移指南。

能构建什么？

• 代币分析工具：追踪价格变动、流动性深度变化和交易量模式
• DEX 比较：分析不同去中心化交易所的费用结构、交易量和可用资金池
• 流动性池分析：监控总锁定价值（TVL）变化、无常损失计算和价格影响评估
• 市场分析：跨链代币比较、交易量趋势和交易活动指标
• 投资组合追踪器：实时价值追踪、历史表现分析和收益机会发现
• 技术分析：使用历史 OHLCV 数据进行高级技术分析，包括趋势识别、形态识别和指标计算

安装指南

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装：

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

手动安装

# 全局安装（推荐常规使用）
npm install -g dexpaprika-mcp

# 验证安装
dexpaprika-mcp --version

# 启动服务器
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 后，Claude 将自动获得 DexPaprika 工具集访问权限。

从 v1.0.x 迁移至 v1.1.0

⚠️ 重大变更

全局 getTopPools 函数已移除（因 API 弃用）。

迁移步骤

旧版 (v1.0.x):

// 以下代码已失效
getTopPools({ page: 0, limit: 10, sort: 'desc', orderBy: 'volume_usd' })

新版 (v1.1.0):

// 改用特定网络查询
getNetworkPools({ network: 'ethereum', page: 0, limit: 10, sort: 'desc', orderBy: 'volume_usd' })
getNetworkPools({ network: 'solana', page: 0, limit: 10, sort: 'desc', orderBy: 'volume_usd' })

// 如需查询多网络，请分别调用 getNetworkPools
// 或使用跨网络搜索功能

新方案优势

• 性能更优：特定网络查询更快更高效
• 结果更相关：获取与用例真正相关的资金池
• 扩展性更强：更适合处理跨网络海量数据

技术能力

MCP 服务器开放以下 Claude 可访问的端点：

网络操作

资金池操作

代币操作

使用示例

// 通过 Claude 获取特定代币详情：
const solanaJupToken = await getTokenDetails({
  network: "solana", 
  tokenAddress: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// 查找某代币所有资金池并按交易量排序：
const jupiterPools = await getTokenPools({
  network: "solana", 
  tokenAddress: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  orderBy: "volume_usd",
  limit: 5
});

// 获取以太坊顶级资金池（v1.1.0 方案）：
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  orderBy: "volume_usd",
  limit: 10
});

// 获取历史价格数据（用于技术分析、机器学习模型、回测等）：
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  poolAddress: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", // Uniswap V3 上的 ETH/USDC
  start: "2023-01-01",
  interval: "1d",
  limit: 30
});

// 1.2.0：批量获取多代币价格（可重复查询）：
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH
    "0xdac17f958d2ee523a2206206994597c13d831ec7"  // USDT
  ]
});

Claude 提示词示例

与 Claude 协作时尝试这些技术查询（已更新至 v1.1.0）：

• "分析 Solana 上的 JUP 代币。获取价格、交易量和顶级流动性池。"
• "比较以太坊上 Uniswap V3 与 SushiSwap 的交易量。"
• "获取 Raydium 上 SOL/USDC 的 7 天 OHLCV 数据并绘制价格图表。"
• "找出 Fantom 网络上流动性前 5 的池并分析其费用结构。"
• "获取 Uniswap 上 ETH/USDT 池的近期交易并分析买卖压力。"
• "使用 getNetworkPools 显示以太坊 24 小时交易量前 10 的池。"
• "搜索包含 ARB 代币的所有池并按交易量排序。"
• "获取 BTC/USDT 的 OHLCV 数据以分析波动模式并构建价格预测模型。"
• "首先获取所有可用网络，然后显示各主要网络的顶级资金池。"

速率限制与性能

• 免费版限制：每分钟 60 次请求
• 响应时间：多数端点在 100-500 毫秒内（视网络情况）
• 数据新鲜度：资金池和代币数据每 15-30 秒更新
• 错误处理：429 状态码表示触发限流
• OHLCV 数据可用性：历史数据通常从代币/池创建日起可用

故障排查

常见问题：

• 速率限制：收到 429 错误时请降低请求频率
• 数据缺失：部分新代币/池可能缺少完整历史数据
• 超时错误：大数据请求可能耗时较长，建议分页处理
• 网络错误：请检查网络连接，本服务需互联网接入
• OHLCV 限制：起止日期最大间隔为 1 年，更长时间段请使用分页

迁移问题：

• "getTopPools 未找到"：该函数已移除，请改用带特定网络参数的 getNetworkPools
• "410 Gone" 错误：使用了已弃用端点，请根据错误信息使用正确端点

开发指南

# 克隆仓库
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# 安装依赖
npm install

# 开发模式运行（代码变更自动重启）
npm run watch

# 生产环境构建
npm run build

# 运行测试
npm test

更新日志

详见 CHANGELOG.md 获取详细版本说明和迁移指南。

许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

更多资源

• DexPaprika API 文档
• 模型上下文协议规范
• DexPaprika - 全面的链上分析市场数据
• CoinPaprika - 全面的加密货币市场数据