关键词

加密货币价格数据市场分析历史数据CoinCap API

使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供实时的加密货币市场数据。它通过 CoinCap API 获取数据，并提供价格查询、市场分析和历史数据分析等功能，帮助 LLM 更好地理解和处理加密货币相关的信息。

主要功能点

  • 实时价格查询 (get-crypto-price): 获取指定加密货币的当前价格和 24 小时统计数据，包括价格、涨跌幅、交易量、市值和市场排名。
  • 市场分析 (get-market-analysis): 提供详细的市场分析，包括交易量排名前五的交易所、交易所之间的价格差异、交易量分布和成交量加权平均价 (VWAP)。
  • 历史数据分析 (get-historical-analysis): 分析加密货币的历史价格数据，支持自定义时间间隔（5 分钟至 1 天），最长可分析 30 天的数据，提供价格趋势和波动性指标。

安装步骤

  1. 安装 Node.js: 确保你的系统已安装 Node.js 运行环境 (建议 v18 或更高版本)，可从 Node.js 官网 下载安装。
  2. 安装 MCP 客户端: 你需要一个支持 MCP 协议的客户端，例如 Claude Desktop。
  3. 配置 MCP 客户端: 打开 MCP 客户端的配置文件（例如 Claude Desktop 的 'claude_desktop_config.json'），添加本 MCP 服务器的配置信息。

服务器配置

以下是在 MCP 客户端配置文件中添加本服务器的配置信息示例 (JSON 格式)。请根据你的 MCP 客户端要求进行配置。

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "npx",
      "args": [
        "-y",
        "@bujaayjaay/mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_COINCAP_API_KEY"  // 必须替换为你自己的 CoinCap API 密钥
      }
    }
  }
}

配置参数说明:

  • '"mcp-coincap-jj"': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
  • '"command": "npx"': 运行服务器的命令，这里使用 'npx'，它会自动查找并执行 'node_modules' 中的包或全局安装的包。
  • '"args": ["-y", "@bujaayjaay/mcp-coincap-jj"]': 传递给 'npx' 的参数。
    • '"-y"': (可选) 'npx' 的参数，表示自动同意安装所需的 npm 包。
    • '"@bujaayjaay/mcp-coincap-jj"': 要执行的 npm 包名称，即本 MCP 服务器的 npm 包名。 'npx' 会下载并执行该包。
  • '"env": { "COINCAP_API_KEY": "YOUR_COINCAP_API_KEY" }': 设置环境变量。
    • '"COINCAP_API_KEY": "YOUR_COINCAP_API_KEY"': 必须配置 CoinCap API 密钥。你需要访问 CoinCap 官网 注册并获取 API 密钥，然后替换 '"YOUR_COINCAP_API_KEY"' 为你的实际密钥。 注意：不提供 API 密钥将无法使用本服务器。

本地开发或贡献者配置 (可选):

如果你是开发者，想要本地安装和运行服务器，可以使用以下配置 (以 Windows 系统为例):

{
  "mcpServers": {
    "mcp-coincap-jj-local": {  // 本地运行的服务器可以设置不同的名称
      "command": "cmd.exe",
      "args": [
        "/c",
        "C:\\Program Files\\nodejs\\npx.cmd", // 替换为你的 npx.cmd 的绝对路径
        "C:\\Users\\YOUR-WINDOWS-USERNAME\\repos\\github\\mcp-coincap-jj" // 替换为你的仓库本地路径
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_COINCAP_API_KEY" // 同样需要配置 API 密钥
      }
    }
  }
}

注意: 需要将 'command' 和 'args' 中的路径替换为你本地 Node.js 和仓库的实际路径。

基本使用方法

配置完成后，在 MCP 客户端中，你可以通过自然语言指令调用本服务器提供的工具来查询加密货币信息。以下是一些示例：

  • 查询比特币 (BTC) 的当前价格: 'What's the current price of Bitcoin?'
  • 获取以太坊 (ETH) 的市场分析: 'Show me market analysis for ETH'
  • 查询狗狗币 (DOGE) 过去 7 天的价格历史: 'Give me the 7-day price history for DOGE'
  • 查询交易比特币 (BTC) 的顶级交易所: 'What are the top exchanges trading BTC?'
  • 显示 Solana (SOL) 以 1 小时为间隔的价格趋势: 'Show me the price trends for SOL with 1-hour intervals'

提示: 在与 LLM 对话时，可以使用以上示例或类似的自然语言指令，LLM 客户端会自动识别并调用本 MCP 服务器提供的工具，返回相应的加密货币数据。你需要确保已经正确配置了 CoinCap API 密钥，否则数据查询会失败。

信息

分类

网页与API

访问项目