CoinGecko MCP 服务器使用说明

项目简介

CoinGecko Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许您通过 Claude Desktop 或其他 MCP 客户端访问 CoinGecko Pro API 的数据。这个服务器提供了一系列工具，用于查询加密货币信息，例如实时价格、历史数据等。

主要功能点

获取加密货币列表：分页获取 CoinGecko 支持的所有加密货币信息。
查找加密货币 ID：通过名称或代号查找 CoinGecko 加密货币 ID。
获取历史数据：查询指定加密货币的历史价格、市值和交易量数据。
获取 OHLC 数据：获取指定加密货币的 OHLC (开盘价、最高价、最低价、收盘价) 蜡烛图数据。
刷新缓存：手动刷新本地加密货币列表缓存。

安装步骤

确保您的电脑上已安装 Node.js 和 npm。
下载或克隆此 GitHub 仓库的代码到本地。
打开命令行终端，进入仓库根目录。
运行 'npm install' 命令安装项目依赖。
在仓库根目录下创建 '.env' 文件，并添加您的 CoinGecko Pro API 密钥：
```
COINGECKO_API_KEY=YOUR_COINGECKO_API_KEY
```
请将 'YOUR_COINGECKO_API_KEY' 替换为您在 CoinGecko Pro API 申请的密钥。

服务器配置

要将此 MCP 服务器添加到 Claude Desktop，您需要编辑 Claude Desktop 的配置文件。根据您的操作系统，配置文件路径如下：

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

在配置文件中，将以下 JSON 代码添加到 'mcpServers' 字段中。如果 'mcpServers' 字段不存在，请先创建它。

{
  "mcpServers": {
    "coingecko": {
      "command": "node",
      "args": ["/path/to/coingecko-server/build/index.js"], //  将 "/path/to/coingecko-server" 替换为您仓库代码的实际路径
      "env": {
        "COINGECKO_API_KEY": "YOUR_COINGECKO_API_KEY" // 您的 CoinGecko API 密钥，与 .env 文件中的密钥保持一致
      }
    }
  }
}

注意:

请将 '"YOUR_COINGECKO_API_KEY"' 替换为您在 '.env' 文件中设置的 CoinGecko Pro API 密钥。
请将 '"/path/to/coingecko-server"' 替换为您本地仓库代码的实际绝对路径。例如，如果您将代码放在用户目录下的 'Documents/mcp-coingecko-server' 文件夹中，那么 macOS 上的路径可能是 '"/Users/your_username/Documents/mcp-coingecko-server"'. Windows 上的路径可能是 '"C:\Users\your_username\Documents\mcp-coingecko-server"'.

配置完成后，重启 Claude Desktop 使配置生效。

基本使用方法

配置并启动 CoinGecko MCP 服务器后，在 Claude Desktop 或其他 MCP 客户端中，您可以使用以下工具来查询 CoinGecko 数据：

get-coins: 获取加密货币列表，支持分页参数 'page' 和 'pageSize'。
find-coin-ids: 通过加密货币名称或代号查找 CoinGecko ID，参数为 'coins' 数组。
get-historical-data: 获取历史数据，参数包括 'id' (加密货币 ID), 'vs_currency' (目标货币), 'from_date' (开始日期，YYYY-MM-DD), 'to_date' (结束日期，YYYY-MM-DD), 和可选的 'interval' (时间间隔)。
get-ohlc-data: 获取 OHLC 数据，参数包括 'id' (加密货币 ID), 'vs_currency' (目标货币), 'from_date' (开始日期，YYYY-MM-DD), 'to_date' (结束日期，YYYY-MM-DD), 和 'interval' (时间间隔，daily 或 hourly)。
refresh-cache: 刷新本地缓存，无参数。

您可以在 MCP 客户端中调用这些工具，并根据工具的参数描述提供相应的参数值，以获取所需的加密货币数据。

关键词