项目简介

本项目 'MCP-BTC-Watch' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 Claude 等大型语言模型（LLM）提供实时的比特币（Bitcoin）价格信息。通过此服务器，LLM 可以获取比特币的当前价格、24小时价格变动百分比以及市值等关键数据，从而增强其在金融信息方面的理解和应用能力。

主要功能点

实时比特币价格查询: 提供比特币的最新价格信息。
多维度数据: 返回价格（美元）、24小时价格变动百分比和市值。
数据来源自动切换: 优先使用 CoinMarketCap API，API 密钥未配置时自动切换至 CoinGecko API 作为备用数据源，保证服务的可用性。
MCP 协议支持: 遵循 MCP 协议，可以通过标准的 JSON-RPC 接口与 MCP 客户端（如 Claude Desktop）进行通信。
健康检查: 提供 '/health' 端点用于监控服务器运行状态。

安装步骤

克隆仓库:

git clone https://github.com/riteshyaaa/MCP-BTC-Watch
cd MCP-BTC-Watch

安装依赖: 确保已安装 Node.js 和 npm，然后运行：
```
npm install
```
构建项目:
```
npm run build
```

配置环境变量: 复制 '.env.example' 文件并重命名为 '.env'，如果需要使用 CoinMarketCap API，请在 '.env' 文件中填入你的 CoinMarketCap API 密钥。如果留空，将自动使用 CoinGecko API。

cp .env.example .env
# 编辑 .env 文件，可选配置 COINMARKETCAP_API_KEY

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）集成，您需要配置客户端以连接到此服务器。以下是 Claude Desktop 客户端的配置示例，您需要将此配置添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中。

配置文件路径:

Windows: '%APPDATA%\Claude\claude_desktop_config.json'
macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Linux: '~/.config/Claude/claude_desktop_config.json'

配置内容 (JSON 格式):

{
  "mcpServers": {
    "btc-price-server": { // 服务器名称，可以自定义
      "command": "node", // 启动服务器的命令
      "args": ["<项目绝对路径>/dist/index.js", "--mcp-server"], // 命令参数，指定启动入口和 MCP 服务器模式
      "env": { // 环境变量
        "COINMARKETCAP_API_KEY": "your-api-key-here" // (可选) CoinMarketCap API 密钥，如果使用 CoinGecko 可以忽略
      }
    }
  }
}

请务必将 '<项目绝对路径>' 替换为 'MCP-BTC-Watch' 项目在您本地文件系统中的绝对路径。 例如：

Windows: 'C:/Users/YourUsername/MCP-BTC-Watch/dist/index.js'
macOS/Linux: '/Users/yourusername/MCP-BTC-Watch/dist/index.js'

基本使用方法

配置完成后，在 Claude 等 MCP 客户端中，您可以使用以下方式指示 LLM 调用此 MCP 服务器的功能：

例如，在 Claude 中，您可以提问：

"What's the current price of Bitcoin?" (比特币现在价格是多少？)
"How much has Bitcoin changed in the last 24 hours?" (比特币过去 24 小时涨跌幅是多少？)
"What's the market cap of Bitcoin right now?" (比特币现在的市值是多少？)

LLM 应该能够理解您的意图，并调用 'get-bitcoin-price' 工具从 MCP 服务器获取数据并回答您的问题。

开发者信息

仓库作者: riteshyaaa 仓库地址: https://github.com/riteshyaaa/MCP-BTC-Watch

关键词