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

一个基于CoinCap API的Model Context Protocol(MCP)服务器,提供实时加密货币价格数据、市场分析和历史趋势。

  • by wazzan
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 wazzan/mcp-coincap-jj

使用说明

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

模型上下文协议(MCP)服务器,使用CoinCap API提供全面的加密货币分析。该服务器通过易于使用的界面提供实时价格数据、市场分析和历史趋势。

📌 关于这个叉子

这是原版的叉子 mcp加密货币价格 Tracey Russell的项目

✅ 发生了什么变化:

  • 更新为使用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
  • 视窗: %APPDATA%/Claude/claude_desktop_config.json

🟢 Windows安装指南(任何MCP客户端的步骤相同)

  1. 安装Node.js:(https://nodejs.org/en)
  2. 安装克劳德桌面
  3. 配置Claude桌面:
  • 打开汉堡菜单(左上角)→ File → 设置→ 开发者→ 编辑配置
  • 这将在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

提供详细的市场分析,包括:

  • 按交易量排名前五的交易所
  • 交易所之间的价格变化
  • 体积分布分析
  • VWAP(成交量加权平均价格)

get-historical-analysis

通过以下方式分析历史价格数据:

  • 可定制的时间间隔(5分钟至1天)
  • 支持长达30天的历史数据
  • 价格趋势分析
  • 波动性指标
  • 高/低价格范围

示例提示

  • “比特币的当前价格是多少?”
  • “向我展示ETH的市场分析”
  • “给我DOGE的7天价格历史”
  • “交易BTC的顶级交易所是什么?”
  • “以1小时为间隔显示SOL的价格趋势”

项目灵感

许可证

该项目根据麻省理工学院许可证获得许可