Crypto Price & Market Analysis MCP Server

加密货币价格与市场分析 MCP 服务

一个通过 CoinCap API 提供全面加密货币分析的模型上下文协议（MCP）服务。该服务通过易于使用的界面提供实时价格数据、市场分析和历史趋势。支持 STDIO 和 Streamable HTTP 传输方式。

要求

• Node.js 22.14+
• 通过 COINCAP_API_KEY 提供 CoinCap API 密钥

更新内容

• 重大变更：已移除 CoinCap v2 API。现在仅使用 v3 API。需要 COINCAP_API_KEY（可在 pro.coincap.io/dashboard 免费获取）
• 新增 Streamable HTTP 传输方式（同时保留 STDIO 兼容性）
• 可通过 STDIO 和 Streamable HTTP 完全独立运行，无需外部注册表或运行时
• 6 个新工具：assets-search、market-global、assets-compare、analysis-candlestick、price-convert、assets-info
• 分层工具命名：所有工具均按类别前缀组织（price-*、market-*、assets-*、analysis-*）
• 输出架构：所有工具现在都声明了 outputSchema，并通过 structuredContent 提供类型安全的响应
• MCP 最佳实践：验证错误中包含 isError 标志、服务描述，以及 asset://{symbol} 资源模板

用法

将此配置添加到 Claude Desktop 配置文件中：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

如果你的 MCP 客户端需要在 Windows 上通过 cmd.exe 启动：

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

开发脚本

pnpm watch         # Development: recompile on change (tsc --watch); pair with `node --watch dist/http.js` for HTTP hot reload
pnpm build         # Compile TypeScript → dist/
pnpm format        # Format source files with Prettier
pnpm lint          # Check for lint errors (ESLint + typescript-eslint)
pnpm lint:fix      # Auto-fix lint errors
pnpm types:check   # TypeScript type-check without emitting files
pnpm test          # Run all tests with Vitest
pnpm test:coverage # Run tests with coverage report (Vitest)
pnpm inspector     # Open MCP inspector for interactive debugging

作为 Streamable HTTP 服务运行

你可以通过 HTTP 运行服务，以适用于支持通过 HTTP 流式传输 MCP 的环境。

• 开发期间，在发生更改时重新构建并重启：

pnpm watch                    # terminal 1: recompile TypeScript
node --watch dist/http.js     # terminal 2: restart the HTTP server on rebuild

• 构建并运行 HTTP 服务：

# Build (outputs to dist/)
pnpm build

# Start the HTTP server
pnpm start:http

• 构建并运行 STDIO 服务：

# Build (outputs to dist/)
pnpm build

# Start the STDIO server
pnpm start:stdio

服务默认监听端口 3000（可通过 PORT 覆盖）。对于通过 HTTP 连接的客户端（例如 Claude.ai、Cursor），请将 API 密钥作为查询参数传入：

http://localhost:3000/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

对于远程部署：

https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

必需：CoinCap API 密钥

此服务使用 CoinCap v3 API，需要 API 密钥。可免费获取。

1. 在 pro.coincap.io/dashboard 注册并获取 API 密钥
2. 将密钥添加到 MCP 客户端配置中：
   • STDIO：通过 COINCAP_API_KEY 环境变量提供（参见上方的用法示例）
   • HTTP：通过连接 URL 中的 COINCAP_API_KEY 查询参数提供（例如 /mcp?COINCAP_API_KEY=your_key）

如果没有有效的 API 密钥，所有工具都会返回错误，并附上获取密钥的说明。

远程 MCP 客户端

此服务可独立运行——客户端可直接连接，无需经过注册表或代理。

• Claude Code（原生 Streamable HTTP）：

claude mcp add --transport http mcp-crypto-price "https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY"

• Claude.ai / Claude Desktop：在 Settings → Connectors 下添加 Custom Connector，并填写上方的远程 URL。
• Cursor 及其他支持远程 MCP 的客户端：将其指向相同的 /mcp URL。
• 仅支持 stdio 的客户端：使用 npx -y mcp-remote "https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY" 桥接到远程端点，或设置 COINCAP_API_KEY 后通过 npx -y mcp-crypto-price 在本地运行（参见上方的用法）。

启动 MCP 客户端即可开始使用加密货币分析工具。

工具

price-get

获取任意加密货币的当前价格和 24 小时统计数据，包括：

• 以 USD 计价的当前价格
• 24 小时价格变动
• 交易量
• 市值
• 市场排名

price-convert

将加密货币金额转换为任意法定货币：

• 使用实时价格数据和以 USD 为基准的汇率
• 参数：symbol（例如 BTC）、amount（默认值为 1）、currency（默认值为 usd）
• 示例：将 2.5 BTC 转换为 EUR

market-analysis

提供详细的市场分析，包括：

• 按交易量排名的前 5 家交易所
• 各交易所之间的价格差异
• 交易量分布分析
• VWAP（成交量加权平均价）

market-global

概述整个加密货币市场：

• 所有资产的总市值
• 24 小时交易量
• 活跃加密货币数量
• 比特币占比
• 涨幅最高和跌幅最大的资产

market-rates

返回以 USD 为基准的法定货币和加密货币兑换汇率：

• 所有法定货币汇率（以 USD 为基准）
• 前 10 种加密货币汇率
• 可选的 slug 参数（例如 euro、bitcoin），用于查询单个汇率

market-exchanges

列出按 24 小时交易量排名的顶级加密货币交易所：

• 交易所名称、排名和以 USD 计的 24 小时交易量
• 交易对数量和市场份额百分比
• 可选的 exchangeId 参数（例如 binance），用于查询单个交易所的详情
• 可选的 limit 参数（1–50，默认值为 10）

assets-top

列出按市值排名的顶级加密货币，包括：

• 以 USD 计的当前价格
• 24 小时价格变化
• 市值和排名
• 可配置结果数量（1–50，默认值为 10）

assets-search

通过模糊匹配，按名称或代号搜索加密货币：

• 返回匹配资产的代号、名称、价格和排名
• 可配置结果数量（1–50，默认值为 10）
• 示例：搜索 "bit" 会返回 Bitcoin、Bitcoin Cash、BitTorrent 等

assets-info

返回单种加密货币的详细元数据：

• ID、排名、代号和名称
• 价格、24 小时变化、市值和交易量
• 流通供应量和最大供应量
• VWAP（24 小时）

assets-compare

并排比较 2–5 种加密货币：

• 每种资产的价格、24 小时变化、市值、交易量和排名
• 以逗号分隔的代号（例如 BTC,ETH,SOL）
• 根据 24 小时变化标出表现最佳的资产

analysis-historical

分析历史价格数据，包括：

• 可自定义的时间间隔（5min 至 1 day）
• 支持最多 30 天的历史数据
• 价格趋势分析
• 波动率指标
• 价格高低区间

analysis-technical

返回任意加密货币的最新技术指标：

• SMA（简单移动平均线）及其周期
• EMA（指数移动平均线）及其周期
• RSI（相对强弱指数），并提供超买／超卖／中性信号
• MACD，包含信号线、柱状图和看涨／看跌标签
• VWAP（成交量加权平均价，24 小时）

analysis-candlestick

获取加密货币的 OHLCV 蜡烛图数据：

• 每根蜡烛的开盘价、最高价、最低价、收盘价和交易量
• 可配置的时间间隔（5m、15m、30m、1h、2h、6h、12h、1d）
• 支持 1–30 天的历史蜡烛数据

资源

该服务提供以下 MCP 资源：

• info://server — 服务名称和版本元数据
• asset://{symbol} — 按代号查询加密货币资产信息（例如 asset://BTC），以 JSON 格式返回

提示词

该服务提供客户端可调用的以下 MCP 提示词：

提示词	参数	描述
analyze-crypto	symbol	全面分析：价格、市场、历史趋势
compare-cryptocurrencies	symbols	并排比较 2–5 种加密货币
market-overview	—	全球市场概览：指标、顶级资产、顶级交易所
crypto-conversion	symbol、amount?、currency?	将加密货币金额转换为法定货币
exchange-analysis	symbol	分析某种加密货币的交易所格局
technical-analysis	symbol	全面技术分析：指标、蜡烛图、趋势
crypto-screener	query	搜索并筛选有潜力的加密货币

示例提示词

• “比特币当前价格是多少？”
• “显示 ETH 的市场分析”
• “提供 DOGE 过去 7 天的价格历史”
• “交易 BTC 的热门交易所有哪些？”
• “显示 SOL 的价格趋势，间隔为 1 小时”
• “ETH 当前的技术指标有哪些？”
• “当前 EUR 兑 USD 的汇率是多少？”
• “哪些加密货币交易所的 24 小时交易量最高？”
• “搜索名称中包含 ‘sol’ 的加密货币”
• “提供加密货币市场的全球概况”
• “并排比较 BTC、ETH 和 SOL”
• “显示 BTC 过去 3 天、间隔为 1 小时的蜡烛图数据”
• “将 2.5 BTC 兑换为 EUR”
• “获取有关 Ethereum 资产的详细信息”
• “生成一份全面的加密货币分析，涵盖价格、市场和历史趋势”
• “查找名称中包含 ‘bit’ 的所有加密货币，并显示其当前价格”
• “Cardano 的市值排名和流通供应量是多少？”
• “比较排名前三的稳定币，并显示哪种交易量最高”
• “显示 Bitcoin 过去 30 天的表现，使用日线蜡烛图”
• “将 100 SOL 兑换为 GBP，并显示汇率”
• “提供完整的市场快照：全球指标、涨幅最高的币种以及 BTC 主导率”
• “过去 24 小时表现最好和最差的加密货币有哪些？”
• “显示 ETH 过去 2 天、间隔为 15 分钟的蜡烛图数据”
• “比较 DeFi 代币：UNI、AAVE、COMP 和 MKR”
• “Bitcoin 的 VWAP 和最大供应量是多少？”
• “搜索 Layer 2 代币，并比较排名靠前的结果”

许可证

本项目采用 MIT License 许可