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@latest

DexPaprika MCP 可将 Claude 连接到多个区块链上的实时 DEX 数据。免费版无需 API 密钥即可开始使用。安装 | 配置 | API 参考

希望零配置？ 使用托管的 MCP 服务 mcp.dexpaprika.com：无需安装，也无需密钥即可开始使用，还能使用相同的数据工具和 submitFeedback。传输端点请参阅托管服务（无需安装）。

最新版本

有关发行说明和迁移指南，请参阅 CHANGELOG.md。

可以构建什么？

• 代币分析工具：跟踪价格走势、流动性深度变化和成交量模式
• DEX 对比：分析不同 DEX 的费用结构、成交量和可用资金池
• 流动性资金池分析：监控 TVL 变化、计算无常损失并评估价格影响
• 市场分析：跨链代币对比、成交量趋势和交易活动指标
• 投资组合跟踪器：跟踪当前价值、分析历史表现并寻找收益机会
• 技术分析：使用历史 OHLCV 数据进行高级技术分析，包括趋势识别、模式识别和指标计算

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 DexPaprika：

npx -y smithery mcp add coinpaprika/dexpaprika

手动安装

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

# Start the server
dexpaprika-mcp

这是一个 stdio 服务：它通过 stdin 和 stdout 使用 MCP 通信，不会绑定任何端口。启动时，它会向 stderr 写入 DexPaprika MCP server v<version> (tool contract v<contract>) is running...，随后等待客户端连接。请从 MCP 客户端（Claude Desktop、Cursor、Claude Code）中运行它，而不要期望在浏览器中获得 URL。

视频教程

观看我们的分步教程，了解如何设置和使用 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@latest"]
    }
  }
}

重启 Claude Desktop 后，Claude 即可自动使用 DexPaprika 工具。

可选：使用 API 密钥

无需密钥即可使用，并且始终如此。 无需注册、无需银行卡，也无需进行任何配置。以上介绍的是受支持的运行方式。

免费密钥可提高每月额度，并允许在任意代币上启用流式数据，而不仅限于公开展示的代币。它不会提高每分钟请求限制，该限制在两个套餐中相同。请前往 console.dexpaprika.com 获取密钥；当前限制请参阅 速率限制页面。

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

密钥应单独填入，作为完整的 Authorization 值。 请按原样粘贴，不要在前面添加任何内容。几乎所有其他 API 都要求在密钥前添加内容，因此这是最常见的原因：明明密钥有效，却看起来无法使用。

有两点值得注意：

• 无法读取的密钥不会触发错误。 数据端点会忽略无法读取的密钥，并将你视为匿名调用者，正常返回 200 和真实数据，因此拼写错误看起来就像请求成功一样。设置密钥后，请让助手运行 getKeyStatus：它会报告 API 实际识别的套餐，并在密钥未生效时指出可能的原因。
• Dev 和 Pro 客户还需要将 DEXPAPRIKA_API_BASE_URL 设置为 https://api-pro.dexpaprika.com，getTokenOHLCV 也需要使用此地址。主机不会自动更改，因为向该主机发送免费密钥会返回 403。

托管服务（无需安装）

如果你希望零配置，可让任何兼容 MCP 的客户端直接连接托管服务：mcp.dexpaprika.com。首页提供设置说明和文档。以下传输端点可用：

传输方式	端点	使用场景
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	推荐用于大多数客户端
SSE	https://mcp.dexpaprika.com/sse	旧版 SSE 传输
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	直接使用 JSON-RPC

注意：这些是 MCP 协议端点，在浏览器中不会显示任何内容。请访问 mcp.dexpaprika.com 查看首页。

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

可用工具（20）

此自托管构建注册了 20 个只读工具：19 个市场数据工具，以及 getKeyStatus。托管服务 mcp.dexpaprika.com 注册了自己的工具集，其中包括 submitFeedback。请通过实时调用 tools/list 验证。

发现

工具	说明
getCapabilities	服务能力、工作流模式、网络别名和最佳实践。从这里开始。
getNetworks	列出所有受支持的区块链网络（36 个）
getStats	高层级生态系统统计数据（网络、DEX、池和代币总数）
search	按名称、符号或地址搜索所有网络中的代币、池和 DEX
getKeyStatus	检查是否发送了密钥，以及 API 识别的套餐。不读取市场数据。

DEX 操作

工具	说明	必需参数
getNetworkDexes	列出指定网络上的 DEX	network

池操作

工具	描述	必需参数
getNetworkPools	主要工具。获取某个网络上的顶级流动性池	network
getDexPools	获取特定 DEX 的池（行位于 results 下，使用游标分页；翻到第一页之后需要密钥）	network、dex
getNetworkPoolsFilter	按交易量、交易笔数和创建时间筛选池	network
getPoolDetails	池的详细信息（价格、交易量、TVL、代币）	network、pool_address
getPoolOHLCV	历史 OHLCV 蜡烛图数据	network、pool_address、start
getPoolIndicator	获取池的 RSI、EMA、MACD、布林带或 VWAP，由服务端根据该池的蜡烛图计算。历史数据范围和时间间隔的计划限制与 getPoolOHLCV 相同	network、pool_address、indicator
getPoolTransactions	获取池的近期交易	network、pool_address

代币操作

工具	描述	必需参数
getTokenDetails	代币详细信息	network、token_address
getTokenPools	包含某个代币的流动性池（按网络筛选，使用 results 和游标分页；翻到第一页之后需要密钥）	network、token_address
getTokenOHLCV	代币的历史美元计价 OHLCV 蜡烛图，按交易该代币的所有池加权计算交易量。需要在 api-pro.dexpaprika.com 使用 Dev 或 Pro 计划；无密钥和免费密钥会收到 403	network、token_address、start
getTokenIndicator	获取代币在所有交易池中的美元计价蜡烛图指标。需要在 api-pro.dexpaprika.com 使用 Dev 或 Pro 计划；无密钥和免费密钥会收到 403	network、token_address、indicator
getTokenMultiPrices	批量获取最多 10 个代币的价格	network、tokens[]
getTopTokens	按交易量、流动性、FDV 或 24 小时价格变化排列的网络顶级代币	network
filterNetworkTokens	按交易量、流动性、FDV、交易笔数和创建时间筛选代币	network

使用示例

// 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). This first page works without
// a key; passing the response's next_cursor back as cursor to fetch a later
// page needs an API key (a free key pages without limit):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (first page, 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: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data for a pool:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

// Get historical USD price data for a token, volume-weighted across every
// pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
// DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
// on a keyless or free key this returns 403, so fall back to getPoolOHLCV
// on the token's main pool (found with getTokenPools) instead.
const tokenOhlcvData = await getTokenOHLCV({
  network: "ethereum",
  token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  start: "-24h",
  interval: "1h",
  limit: 24
});

// RSI for a pool, computed server-side (no need to fetch candles first).
// Send only the parameters of the indicator you ask for: period for rsi, ema,
// bbands and vwap; fast_period, slow_period and signal_period for macd;
// std_dev for bbands. Any other parameter is refused with 400.
const rsi = await getPoolIndicator({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  indicator: "rsi",
  interval: "1h",
  start: "-24h"
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Claude 提示词示例

• “分析 Solana 上的 JUP 代币。获取价格、交易量和顶级流动性池。”
• “比较 Ethereum 上 Uniswap V3 和 SushiSwap 的交易量。”
• “获取 Raydium 上 SOL/USDC 过去一天的每小时 OHLCV 数据，并绘制价格图表。”
• “查找 Fantom 网络上流动性最高的 5 个池，并分析其费用结构。”
• “获取 Uniswap 上 ETH/USDT 池的近期交易，并分析买卖压力。”
• “显示 Ethereum 上 24 小时交易量最高的 10 个池。”
• “搜索所有包含 ARB 代币的池，并按交易量排序。”
• “筛选过去一周创建且 24 小时交易量超过 100,000 美元的 Ethereum 池。”
• “先获取所有可用网络，再显示每个主要网络上的顶级池。”

速率限制与性能

• 免费套餐：无需密钥，无需注册，每分钟 15 次请求。免费的 API 密钥可将请求数提升至每分钟 30 次，提高月度配额，并解锁流式传输功能：请访问 https://console.dexpaprika.com 注册。Pro 套餐每月 $99，可支持每分钟 500 次请求；另有每月 $30、支持每分钟 120 次请求的 Dev 套餐。每次请求消耗 1 个额度；批量端点按每个项目消耗 1 个额度。完整文档请访问 https://docs.dexpaprika.com。月度配额会变动，请以此处的信息为准，而非本页面：https://dexpaprika.com/api/pricing
• 分页搜索结果需要密钥：对于 getNetworkPools、getDexPools、getNetworkPoolsFilter、getTokenPools、filterNetworkTokens 和 getTopTokens，无需密钥即可获取第一页，但传入 cursor 获取后续页面时需要 API 密钥。免费密钥支持无限分页。
• 数据延迟：免费套餐最多延迟 60 秒；付费套餐提供实时数据
• 响应时间：大多数端点为 100-500ms（因网络而异）
• 错误处理：提供包含错误代码、建议和重试指引的结构化错误信息
• OHLCV 数据可用性：通常可获取从代币／池创建日期起的历史数据

故障排除

常见问题：

• 速率限制：如果收到 DP429_RATE_LIMIT 错误，请实现指数退避
• 缺少数据：某些较新的代币／池可能没有完整的历史数据
• 超时错误：大型数据请求可能需要更长时间，可考虑使用分页
• 网络错误：请检查网络连接；该服务需要互联网访问
• OHLCV 限制：单次请求最多返回 1000 根蜡烛图（limit）；若要查询更长时间范围，请向前移动 start 并再次请求。无需密钥时，OHLCV 在 1h 粒度下仅涵盖最近 24 小时及更长时间（start: "-24h"）；免费密钥可查询最近 7 天及更长时间，粒度为 10m。请参阅各套餐的 OHLCV 限制
• 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 许可，详情请参阅 LICENSE 文件。

更多资源

• DexPaprika API 文档
• 托管式 MCP 服务，无需设置即可使用
• Model Context Protocol 规范
• DexPaprika - 全面的链上分析市场数据
• CoinPaprika - 全面的加密货币市场数据