mcp-coincap-jj

Crypto Price & Market Analysis MCP Server (JJ Fork)

一个使用 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 Desktop 配置文件位置：

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

---

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

1. 安装 Node.js：（https://nodejs.org/en）
2. 安装 Claude Desktop
3. 配置 Claude Desktop：

• 打开汉堡菜单（左上角）→ File → Settings → Developer → Edit Config
• 这会在 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 安装（可选但简单）

虽然这会减少一些亲自学习的机会，但它是一个很好的快速入门方式！

1. 确保已为 Claude Desktop 应用安装 Smithery
2. 运行以下命令：

   smithery install @bujaayjaay/mcp-coincap-jj
   

3. 设置期间，系统会提示你输入 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 天的历史数据
• 价格趋势分析
• 波动性指标
• 价格高低区间

示例提示词

• “Bitcoin 的当前价格是多少？”
• “为 ETH 显示市场分析。”
• “提供 DOGE 过去 7 天的价格历史。”
• “有哪些交易量最大的交易所正在交易 BTC？”
• “按 1 小时间隔显示 SOL 的价格趋势。”

项目灵感来源

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

许可证

本项目采用 MIT 许可证