加密货币价格查询服务

MCP Crypto Price Server 是一个基于 CoinGecko API 的简单服务,用于获取指定加密货币的当前价格。

  • by linbiaowen
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 linbiaowen/mcp-server-sample

使用说明

MCP加密货币价格服务器

这是一个简单的MCP服务器,暴露了一个使用CoinGecko API获取指定货币的加密货币当前价格的工具。

设置

  1. 克隆此仓库或复制文件。
  2. 安装依赖项:
    pip install -r requirements.txt
    
  3. 设置CoinGecko API密钥:
    • 从获取API密钥 CoinGecko 的.
    • 首选: 编辑 api_key.txt 并使用以下格式将API密钥放入其中(密钥=值):
      COINGECKO_API_KEY=your_actual_api_key_here
      
    • 备选方案: 如果 api_key.txt 缺失或为空,您可以设置 COINGECKO_API_KEY 环境变量:
      export COINGECKO_API_KEY=your_actual_api_key_here
      
    • 优先: 服务器将使用密钥 api_key.txt 如果存在且非空。只有当该文件丢失或为空时,它才会使用环境变量。

运行服务器

您可以在开发模式下运行服务器(建议用于本地测试):

uv run mcp dev server.py

或者直接运行:

python server.py

用法

服务器公开了一个工具:

  • get_crypto_price(crypto_id: str, currency: str = "usd") -> float

示例调用:

  • get_crypto_price("bitcoin", "usd") #返回BTC的美元价格
  • get_crypto_price("ethereum", "eur") #返回ETH价格(欧元)

备注

  • 需要有效的CoinGecko API密钥。服务器将使用 api_key.txt (以key=value格式)如果存在且非空,否则将使用 COINGECKO_API_KEY 环境变量。
  • 看 CoinGecko API文档 用于有效的加密货币ID和货币。