使用说明

项目简介

该项目是一个 MCP (Model Context Protocol) 服务器,旨在为大型语言模型 (LLM) 应用提供访问 Coinmarket API 加密货币市场数据的能力。通过该服务器,LLM 可以获取最新的加密货币列表和特定加密货币的实时行情数据。

主要功能点

  • 资源 (Resources): 提供加密货币列表和行情数据资源,允许 LLM 客户端通过标准 URI 访问。
  • 工具 (Tools): 注册 'get-currency-listings' 和 'get-quotes' 两个工具,允许 LLM 客户端调用以获取加密货币数据。
  • 配置: 需要 Coinmarket API 密钥才能正常运行。

安装步骤

  1. 确保已安装 Python 和 pip。
  2. 克隆该 GitHub 仓库到本地。
  3. 进入仓库目录。
  4. (可选,如果需要本地开发)创建一个虚拟环境并激活。
  5. 安装项目依赖 (虽然仓库中没有 'requirements.txt' 或 'pyproject.toml',但假设需要安装 'mcp-server' 和 'python-dotenv' 以及 'requests',用户需要自行安装):
    pip install mcp-server python-dotenv requests
  6. 设置 Coinmarket API 密钥环境变量 'COINMARKETCAP_API_KEY'。可以将密钥添加到 '.env' 文件或直接设置到系统环境变量中。

服务器配置

以下 JSON 配置信息用于 MCP 客户端(例如 Claude Desktop)连接到此 MCP 服务器。请根据实际情况修改 'command' 和 'args' 中的路径。

{
  "server_name": "coinmarket_service",  // 服务器名称,客户端用于识别
  "command": "uv",                     // 启动服务器的命令,这里假设使用 uv (or python) 运行
  "args": [                            // 启动命令的参数
    "--directory",                     // 指定工作目录
    "/path/to/anjor_coinmarket-mcp-server/src", // 替换为你的仓库 src 目录的绝对路径
    "run",                             // 使用 uv run (or python -m) 运行模块
    "coinmarket_service"                // 要运行的 Python 模块名
  ],
  "env": {                              // 环境变量
    "COINMARKET_API_KEY": "<your_coinmarket_api_key>" // 替换为你的 Coinmarket API 密钥
  }
}

基本使用方法

  1. 启动 MCP 服务器。根据上面的配置,在终端中执行配置中 'command' 和 'args' 对应的命令即可启动服务器。
  2. 在支持 MCP 协议的 LLM 客户端(例如 Claude Desktop)中,配置上述服务器配置信息。
  3. LLM 客户端将能够发现服务器提供的资源和工具,并可以使用自然语言指令调用这些功能,例如:
    • "获取最新的加密货币列表" (可能会触发 'get_currency_listings' 工具)
    • "查询比特币的行情" (可能会触发 'get_quotes' 工具,参数为 slug 或 symbol)

信息

分类

网页与API