加密货币价格监控服务

一个基于MCP协议的加密货币价格监控服务,通过CoinGecko API提供实时价格、历史数据、市场统计和比较工具。

  • by Isallkun
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Isallkun/mcp-crypto

使用说明

MCP加密货币价格监视器

模型上下文协议(MCP)服务器,用于使用CoinGecko API监控加密货币价格和市场数据。该服务器允许LLM直接通过MCP接口检索实时数据、历史图表和全球市场统计数据。

特性

  • 实时价格:获取多种货币(美元、印尼盾等)的当前价格。
  • 主流币:按市值列出顶级加密货币。
  • 详细见解:准入市场排名、历史最高(ATH)、历史最低(ATL)和供应数据。
  • 价格历史记录:检索OHLC(打开、高、低、关闭)历史数据进行分析。
  • 全球市场统计:监控总市值、BTC/ETH主导地位和活跃市场。
  • 硬币搜索:按名称或符号查找加密货币。
  • 比较工具:并排比较多个硬币。

安装

先决条件

  • Python 3.13或更高版本
  • 紫外线 (推荐)或pip

设置

  1. 克隆此存储库:
    git clone https://github.com/your-username/mcp-crypto.git
    cd mcp-crypto
    
  2. 安装依赖项:
    uv sync
    # or
    pip install httpx mcp[cli] python-dotenv
    

用法

运行服务器

您可以在本地运行服务器进行测试:

uv run main.py

与Claude Desktop集成

要将此服务器与Claude Desktop一起使用,请将以下配置添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "crypto-monitor": {
      "command": "uv",
      "args": ["--directory", "D:/Project/mcp-crypto", "run", "main.py"]
    }
  }
}

(确保更换 D:/Project/mcp-crypto 与您的实际绝对路径)

可用工具

工具 说明
get_price 获取特定货币的一个或多个硬币的当前价格。
get_coin_detail 获取特定硬币的完整市场数据、ATH、ATL和描述。
get_top_coins 按市值列出前N种加密货币。
search_coin 按名称或符号搜索硬币。
get_global_market 获取全球指标,如总市值和BTC主导地位。
get_price_history 获取指定天数的OHLC历史数据。
compare_coins 在单个视图中并排比较多个硬币。

数据源

数据由 CoinGecko API。此服务器使用免费层,该层不需要API密钥,但有速率限制。

许可证

MIT许可证