DexPaprika MCP Server

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 小时交易量超过 10 万美元且在过去一周内创建的流动性池。”
• “首先获取所有可用网络，然后显示每个主要网络上的顶级流动性池。”

速率限制与性能

• 免费套餐限制：每天 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 - 全面的加密货币市场数据