Bitcoin Price Tracker

🚀 比特币价格 MCP 服务器

本项目是一个 Model Context Protocol (MCP) 服务器，专为 Claude AI 提供实时比特币价格数据访问服务。借助该服务器，Claude 能够轻松获取比特币的当前价格以及相关市场信息。

🚀 快速开始

本服务器能助力Claude获取比特币实时价格及市场信息。按以下步骤操作，即可快速开启使用。

✨ 主要特性

• 🔄 为 Claude 提供实时比特币价格信息。
• 💹 返回美元（USD）价格、24 小时变化百分比和市值。
• 📡 处理加密货币数据提供商的 API 调用。
• ⚙️ 在 CoinMarketCap 和 CoinGecko API 之间实现自动故障转移。

📦 安装指南

先决条件

• 已安装 Node.js 和 npm。
• 拥有 CoinMarketCap API 密钥（获取方式：pro.coinmarketcap.com）。

  ⚠️ 重要提示

  若没有 CoinMarketCap API 密钥，工具将自动使用 CoinGecko API。

安装步骤

# 克隆此仓库
git clone [your-repository-url]
cd btc-price-mcp

# 安装依赖项
npm install

# 构建 TypeScript 代码
npm run build

📚 详细文档

配置

1. 复制 .env.example 文件为 .env：

   cp .env.example .env
   

2. 编辑 .env 文件并添加您的 CoinMarketCap API 密钥：

   COINMARKETCAP_API_KEY=your_api_key_here
   

作为 CLI 工具使用

您可将其作为命令行工具检查比特币价格：

# 使用 npm
npm start

# 或直接通过 node
node dist/index.js

您还能使用包含的批处理文件：

• bt-price.bat 或 btc-price.bat

与 Claude Desktop 集成

要将此 MCP 服务器与 Claude Desktop 集成：

1. 找到 Claude Desktop 的配置文件：
   • 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json
   • 在 macOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 在 Linux 上：~/.config/Claude/claude_desktop_config.json
2. 将以下配置添加到文件中：

{
  "mcpServers": {
    "btc": {
      "command": "node",
      "args": ["<FULL_PATH_TO_YOUR_PROJECT>/dist/index.js"],
      "env": {
        "COINMARKETCAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

将 <FULL_PATH_TO_YOUR_PROJECT> 替换为您的项目目录的绝对路径。 例如在 Windows 上：C:/Users/RITESH YADAV/Desktop/Lab/dist/index.js

使用说明

配置完成后，您可以让 Claude 查询比特币价格：

• "当前比特币的价格是多少？"
• "过去 24 小时内比特币变化了多少？"
• "比特币的当前市值是多少？"

开发

该项目设计用于与 Model Context Protocol 规范配合使用。您可以修改可用工具或添加新的加密货币端点，只需编辑 src/index.ts 文件并重新构建项目。

📄 许可证

本项目采用 MIT 许可证。