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

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

使用

将此配置添加到您的 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"]
    }
  }
}

作为可流式传输的 HTTP 服务器运行

您可以在支持通过 HTTP 流式传输 MCP 的环境中运行该服务器。

开发服务器（推荐在开发期间使用）：

npm run dev

构建并运行 HTTP 服务器：

# 构建 HTTP 包（输出到 .smithery/）
npm run build

# 启动 HTTP 服务器
npm run start:http

构建并运行 STDIO 服务器：

# 构建 STDIO 包（输出到 dist/）
npm run build:stdio

# 启动 STDIO 服务器
npm run start:stdio

开发/构建命令将在控制台中打印服务器地址。在支持通过 HTTP 传输 MCP 的客户端（例如 Smithery）中使用该 URL。您可以通过 COINCAP_API_KEY 提供 API 密钥以获得更高的速率限制。

可选：CoinCap API 密钥

为了获得更高的速率限制，请在配置中添加 API 密钥：

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

重要提示：CoinCap 正在逐步淘汰其 v2 API。此 MCP 支持 v2 和 v3 API：

如果您提供 COINCAP_API_KEY，它将首先尝试使用 v3 API，必要时回退到 v2

如果没有 API 密钥，它将使用 v2 API（最终将被弃用）

建议从 pro.coincap.io/dashboard 获取 API 密钥，因为 v2 API 将来会完全停用

启动 Claude Desktop 以开始使用加密货币分析工具。

已验证的提交 & SSH 签名

此仓库要求提交经过验证（加密签名）。CI 还包括一个任务（验证提交签名），该任务将拒绝包含未签名提交的 PR。

创建 SSH 签名密钥（一次性）

# 生成一个新的 ed25519 SSH 密钥（无密码使 CI 更容易）
ssh-keygen -t ed25519 -C "mcp-crypto-price 的 CI 签名密钥" -f ~/.ssh/id_ed25519 -N ''

# 您的密钥将位于：
#   私钥: ~/.ssh/id_ed25519
#   公钥: ~/.ssh/id_ed25519.pub

在本地启用 SSH 签名（可选但推荐）

git config --global gpg.format ssh
git config --global user.signingkey ~/.ssh/id_ed25519.pub
git config --global commit.gpgsign true

# 示例签名提交
git commit -S -m 'feat: 添加某些内容'

配置 GitHub 以验证您的签名

在您的 GitHub 账户中添加您的公钥作为 SSH 签名密钥：
- GitHub → 设置 → SSH 和 GPG 密钥 → 新建 SSH 密钥
- 密钥类型：签名密钥（SSH）
- 粘贴 ~/.ssh/id_ed25519.pub 的内容

工具

get-crypto-price

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

当前美元价格
24 小时价格变化
交易量
市值
市场排名

get-market-analysis

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

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

get-historical-analysis

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

可自定义的时间间隔（5 分钟到 1 天）
支持最多 30 天的历史数据
价格趋势分析
波动性指标
高/低价格范围

示例提示

"比特币的当前价格是多少？"
"展示 ETH 的市场分析"
"给我 DOGE 的 7 天价格历史"
"交易 BTC 的顶级交易所有哪些？"
"展示 SOL 的 1 小时间隔价格趋势"

项目灵感

该项目受到 Alex Andru 的 coincap-mcp 项目的启发。

许可证

该项目采用 MIT 许可证