加密货币价格分析服务

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

  • by truss44
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 truss44/mcp-crypto-price

使用说明

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

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

新增功能

  • 添加了流式HTTP传输(同时保持STDIO兼容性)
  • 发布工作流通过SSH签署已验证发布的提交
  • 用于构建和运行HTTP服务器的Smithery CLI脚本

用法

将此配置添加到您的Claude Desktop配置文件中:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"]
    }
  }
}

以流式HTTP服务器运行

对于支持MCP over HTTP流式传输的环境,您可以通过HTTP运行服务器。

  • 开发服务器(建议在开发过程中使用):
npm run dev
  • 构建并运行HTTP服务器:
# Build the HTTP bundle (outputs to .smithery/)
npm run build

# Start the HTTP server
npm run start:http
  • 构建并运行STDIO服务器:
# Build the STDIO bundle (outputs to dist/)
npm run build:stdio

# Start the STDIO server
npm run start:stdio

dev/build命令将把服务器地址打印到控制台。在支持MCP over HTTP的客户端(例如Smithery)中使用该URL。您可以选择通过提供API密钥 COINCAP_API_KEY 对于更高的速率限制。

可选: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(最终将停止使用)
  • 建议从获取API密钥 pro.coincap.io/仪表板 因为v2 API将来将完全停用

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

已验证的提交和SSH签名

此存储库需要验证(加密签名)提交。CI还包括一个工作(Verify commit signatures)这会导致未签名提交的PR失败。

创建SSH签名密钥(一次)

# Generate a new ed25519 SSH key (no passphrase makes CI easier)
ssh-keygen -t ed25519 -C "CI signing key for mcp-crypto-price" -f ~/.ssh/id_ed25519 -N ''

# Your keys will be at:
#   Private: ~/.ssh/id_ed25519
#   Public : ~/.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

# Example signed commit
git commit -S -m 'feat: add something'

配置GitHub以验证您的签名

  1. 将您的公钥作为SSH签名密钥添加到您的GitHub帐户中:
    • GitHub→ 设置→ SSH和GPG密钥→ 新SSH密钥
    • 密钥类型:签名密钥(SSH)
    • 粘贴内容 ~/.ssh/id_ed25519.pub

工具

获取加密货币价格

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

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

获取市场分析

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

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

进行历史分析

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

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

示例提示

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

项目灵感

这个项目的灵感来自Alex Andru的 coincap mcp 项目。

许可证

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