CoinPaprika

CoinPaprika MCP 服务

一种模型上下文协议（MCP）服务，可按需访问 CoinPaprika 的加密货币市场数据 API。该服务专为 Claude 等 AI 助手打造，可在无需任何配置的情况下，以编程方式获取实时价格、行情、交易所数据、OHLCV 蜡烛图等信息。

简介

# Install globally
npm install -g @coinpaprika/mcp

# Start the server
coinpaprika-mcp

# Or run directly without installation
npx @coinpaprika/mcp@latest

CoinPaprika MCP 可将 Claude 连接到涵盖 12,000 多种加密货币的实时市场数据。免费套餐无需 API 密钥。安装 | 配置 | API 参考

想要零配置？ 使用托管 MCP 服务 mcp.coinpaprika.com：无需安装，也无需 API 密钥即可开始使用，提供 31 个工具（这里的 30 个工具加上 submitFeedback）。传输端点请参阅托管服务。

你可以构建什么？

• 市场仪表盘：实时市场概览，包含全球统计数据、热门币种和成交量趋势
• 币种分析工具：深入了解任意加密货币：价格、团队、事件、交易所和市场
• 价格追踪器：通过历史 OHLCV 数据追踪多种计价货币的价格
• 交易所比较：比较 350 多家交易所的交易对和成交量
• 投资组合估值：在不同货币之间换算金额（“0.5 BTC 兑换成 USD”），并追踪价格随时间的变化
• 合约查询：通过智能合约地址查找多个平台上的代币

安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 CoinPaprika MCP：

npx -y smithery mcp add coinpaprika/coinpaprika

手动安装

# Install globally (recommended for regular use)
npm install -g @coinpaprika/mcp

# Start the server
coinpaprika-mcp

Claude Desktop 集成

将以下内容添加到 Claude Desktop 配置文件中：

macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["@coinpaprika/mcp@latest"]
    }
  }
}

使用 API 密钥（适用于付费套餐功能）

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["@coinpaprika/mcp@latest"],
      "env": {
        "COINPAPRIKA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code 集成

# Add as MCP server in Claude Code
claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

# With API key
COINPAPRIKA_API_KEY=your-key claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

托管服务（无需安装）

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

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

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

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

可用工具（30 个）

发现与系统

工具	描述
getCapabilities	服务能力、工作流模式、验证规则和最佳实践。从这里开始。
status	服务状态和配置
getGlobal	全球市场概览：总市值、24 小时成交量、BTC 市场占比（“市场行情如何”）

币种

工具	描述	必需参数
getCoins	列出所有币种（ID、名称、代号、排名）；不含价格，查询价格请使用 getTickers	无
getCoinById	币种项目信息（描述、团队、链接）；不含价格，查询价格请使用 getTickersById	coinId
getCoinEvents	某币种的即将发生事件	coinId
getCoinExchanges	上架某币种的交易所	coinId
getCoinMarkets	交易某币种的市场／交易所（“在哪里购买 X”“X 在 Binance 上的价格”）	coinId

代币与价格

工具	描述	必需参数
getTickers	按市值排名的顶级代币（“市值前 5 的代币”、市场快照）的当前价格和市值	无
getTickersById	单个代币的当前价格、市值和 24 小时涨跌幅（“BTC 价格”、“ETH 多少钱”）	coinId
getCoinOHLCVLatest	最新完整日线 OHLC 蜡烛图（不是实时价格）	coinId
getCoinOHLCVToday	今日进行中的 OHLC 蜡烛图	coinId
priceConverter	在货币之间转换金额（“0.5 BTC 换算成 USD”）	baseCurrencyId、quoteCurrencyId

交易所

工具	描述	必需参数
getExchanges	列出所有交易所	无
getExchangeByID	交易所详情	exchangeId
getExchangeMarkets	特定交易所的市场	exchangeId

标签与人员

工具	描述	必需参数
getTags	列出所有标签/类别	无
getTagById	标签详情	tagId
getPeopleById	人员/团队成员详情	personId

合约

工具	描述	必需参数
getPlatforms	列出合约平台	无
getContracts	平台上的合约	platformId
getTickerByContract	按合约地址查询代币价格（链上/DeFi 代币）	platformId、contractAddress

搜索与解析

工具	描述	必需参数
search	按名称搜索代币/交易所/人员/标签；先调用以获取 ID	q
resolveId	将名称/符号解析为规范 ID；在调用价格工具前先调用	type、query

付费套餐工具

这些工具需要付费的 CoinPaprika API 套餐。没有 API 密钥时，它们会返回指引，提示你升级。

工具	所需套餐	描述
getCoinOHLCVHistorical	Starter+	历史 OHLCV 蜡烛图数据
getTickersHistoricalById	Starter+	历史行情快照
getHistoricalTickerByContract	Starter+	按合约查询历史行情
getChangelogIDs	Starter+	代币 ID 变更日志
keyInfo	Pro	验证 API 密钥详情
getMappings	Business	跨平台 ID 映射

API 密钥配置

免费套餐无需 API 密钥即可使用大多数工具。对于付费套餐功能（历史数据、映射等），请设置 COINPAPRIKA_API_KEY 环境变量：

# Set via environment variable
export COINPAPRIKA_API_KEY=your-api-key-here
coinpaprika-mcp

# Or pass inline
COINPAPRIKA_API_KEY=your-api-key-here npx @coinpaprika/mcp@latest

请访问 coinpaprika.com/api/pricing 获取 API 密钥。

使用示例

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get global market overview:
const global = await getGlobal();

// Find a coin by name:
const results = await search({ q: "ethereum" });

// Get detailed coin info:
const bitcoin = await getCoinById({ coinId: "btc-bitcoin" });

// Get current ticker with USD and BTC quotes:
const ticker = await getTickersById({ coinId: "eth-ethereum", quotes: "USD,BTC" });

// Get OHLCV data for today:
const ohlcv = await getCoinOHLCVToday({ coinId: "btc-bitcoin" });

// Convert 1 BTC to USD:
const conversion = await priceConverter({
  baseCurrencyId: "btc-bitcoin",
  quoteCurrencyId: "usd-us-dollars",
  amount: 1
});

// List top 10 exchanges:
const exchanges = await getExchanges({ limit: 10 });

// Resolve fuzzy query to exact coin ID:
const resolved = await resolveId({ type: "coin", query: "cardano" });

Claude 提示词示例

• “Bitcoin 和 Ethereum 当前价格是多少？请显示 24 小时涨跌幅。”
• “全面分析 Cardano：价格、团队、事件和顶级交易所。”
• “按交易量比较排名前 5 的加密货币交易所。”
• “将 10 ETH 换算成 USD，并显示当前汇率。”
• “查找所有带有 ‘defi’ 标签的代币，并显示其市值。”
• “哪些交易所上线了 Solana？有哪些可用的交易对？”
• “显示 Bitcoin 今天的 OHLCV 数据。”
• “搜索所有与 ‘layer-2’ 相关的代币，并按市值排名。”
• “查询 Ethereum 背后的团队。有哪些关键人物？”
• “按 Ethereum 合约地址获取 USDT 的行情。”

速率限制与性能

• 免费套餐限制：每月 20,000 次调用，无需 API 密钥。付费套餐起价为 $99/月，可调用 400,000 次：https://coinpaprika.com/api/pricing/
• 响应时间：大多数端点为 100-500ms
• 数据覆盖范围：12,000 多种加密货币、350 多家交易所
• 错误处理：提供包含代码、建议和重试指引的结构化错误
• 配额信息：自行运行此软件包时，每个响应都包含一个 meta.quota 块，其中列出每月免费套餐的限额，以及此服务进程启动以来发出的调用次数。该计数仅针对当前进程，并非你的账户余额。托管服务 mcp.coinpaprika.com 完全不会返回 meta 块，因此不要编写依赖该块的客户端代码

故障排除

常见问题：

• 速率限制：如果收到 CP429_RATE_LIMIT 错误，请退避后重试。免费套餐的配额按月计算，而非按日计算，因此持续出现 429 错误表示月度限额已用尽
• 无效的币种 ID：币种 ID 使用 symbol-name 格式（例如 btc-bitcoin，而非 bitcoin 或 BTC）。使用 search 或 resolveId 查找正确的 ID
• 付费套餐错误：CP402_INSUFFICIENT_PLAN 或 CP403_FORBIDDEN 表示该端点需要付费套餐。请设置 COINPAPRIKA_API_KEY 环境变量
• 超时错误：大型数据请求可能耗时更久，请减小 limit 参数
• 网络错误：检查网络连接；此服务需要互联网访问权限

开发

# Clone the repository
git clone https://github.com/coinpaprika/coinpaprika-mcp.git
cd coinpaprika-mcp

# Install dependencies
npm install

# Run in development
npm start

# Build for production
npm run build

更新日志

详见 CHANGELOG.md 中的详细发行说明。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

其他资源

• CoinPaprika API 文档
• API 定价与套餐
• 托管 MCP 服务，无需配置即可使用
• DexPaprika MCP，提供 DEX 和 DeFi 数据的配套软件包
• Model Context Protocol 规范
• CoinPaprika，全面的加密货币市场数据
• DexPaprika，链上 DEX 分析