加密货币价格与市场分析 MCP 服务器 (JJ 分支)

这是一个使用 CoinCap API 提供全面加密货币分析的 Model Context Protocol (MCP) 服务器。该服务器通过易于使用的界面提供实时价格数据、市场分析和历史趋势。

📌 关于此分支

这是由 Tracey Russell 创建的原始 mcp-crypto-price 项目的分支

✅ 更改内容：

更新为使用 CoinCap v3 API（因为 v2 即将停用）。
计划在时间允许的情况下进行额外的改进和测试。

💡 向 Coin Cap 致敬，感谢他们的“质押换API”订阅模式——我希望更多的API提供商能够采用这种模式。订阅疲劳是真实存在的！

包注释：此项目托管在 GitHub 上，名为 wazzan/mcp-coincap-jj，但在 npm 上发布为 @bujaayjaay/mcp-coincap-jj

🚀 快速启动指南（首次用户）

如果你是第一次使用 MCP 服务器，本指南将为你提供逐步操作说明以帮助你开始。

我在 Windows 11 虚拟机上进行了测试，以避免在我的 Mac 上造成混乱——一切运行良好！

Claude 桌面配置文件位置：

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

🟢 Windows 设置指南（适用于任何 MCP 客户端的相同步骤）

安装 Node.js: (https://nodejs.org/en)
安装 Claude Desktop
配置 Claude Desktop：
- 打开汉堡菜单（左上角）→ 文件 → 设置 → 开发者 → 编辑配置
- 这将在 Windows 资源管理器中打开 claude_desktop_config.json 文件的位置。
- 使用你喜欢的编辑器编辑它，并添加以下配置（确保包含所有闭合括号！）：

注意你可以使用相同的说明来配置其他任何 MCP 客户端

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "npx",
      "args": [
        "-y",
        "@bujaayjaay/mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "INPUT_YOUR_API_KEY_HERE"
      }
    }
  }
}

🛠️ 开发者设置（本地安装）

对于希望在本地工作的开发者和贡献者：

🖥️ 选项 1：从 npm 安装

npm install @bujaayjaay/mcp-coincap-jj

🖥️ 选项 2：克隆并本地运行

git clone https://github.com/wazzan/mcp-coincap-jj.git
cd mcp-coincap-jj
npm install        # Install dependencies
npm run build      # Compile TypeScript code
npm test           # Run tests to verify everything works
npm start          # Starts the MCP server locally

本地测试的 MCP 服务器配置（Windows 示例）

如果使用 npx 本地运行，请在 Claude Desktop（或任何 MCP 客户端）中使用以下配置：

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "C:\\Program Files\\nodejs\\npx.cmd",
        "C:\\Users\\YOUR-WINDOWS-USERNAME\\repos\\github\\mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 专业提示：在 Windows 上使用绝对路径可以确保顺畅的体验，尤其是在运行多个环境时。

Smithery 安装（可选但简单）

虽然这会减少一些个人学习经验，但它是一个很好的快速入门方法！

确保你的 Claude Desktop 应用已安装 Smithery

运行以下命令：

smithery install @bujaayjaay/mcp-coincap-jj

在设置过程中，系统会提示你输入 CoinCap API 密钥

更新：CoinCap API 密钥

你需要从 CoinCap 获取 API 密钥以使用更新后的 v3 API，因为 v2 即将被弃用： (https://pro.coincap.io/api-docs/)

⚡ 使用 - 工具

`get-crypto-price`

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

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

`get-market-analysis`

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

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

`get-historical-analysis`

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

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

示例提示

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

项目灵感

本项目是 Tracey Russell 的 mcp-crypto-price 的一个分支，
Tracey 的项目受到了 Alex Andru 的 coincap-mcp 项目的启发。

许可证

本项目采用 MIT 许可证。