JinDaGe - Bitcoin Price Tracker MCP Details

article

README

🚀 比特币价格 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

📚 详细文档

配置

复制 .env.example 文件为 .env：
```
cp .env.example .env
```
编辑 .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 集成：

找到 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
将以下配置添加到文件中：

{
  "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 许可证。

Bitcoin Price Tracker