关键词

加密货币数据CoinMarketCap API市场行情数字货币信息币价查询

项目简介

Coin MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为 AI 应用提供访问 CoinMarketCap 加密货币数据的能力。通过此服务器，AI 应用可以获取最新的加密货币列表、市场报价以及详细信息，从而扩展 AI 应用在金融和加密货币领域的应用场景。

主要功能点

  • 获取加密货币列表 (listing-coins): 检索所有活跃加密货币的分页列表，包含最新的市场数据。可以根据价格、市值等条件进行筛选和排序，帮助用户快速了解市场概况或特定类型的加密货币。
  • 获取加密货币信息 (get-coin-info): 获取特定加密货币的详细信息，例如 logo、描述、官网链接、社交媒体链接和技术文档链接。这为用户提供了深入了解特定加密货币背景和相关资源的能力。
  • 获取加密货币报价 (get-coin-quotes): 获取一个或多个加密货币的最新市场报价。支持将报价转换为多种法币和加密货币，方便用户进行多币种的价值比较和分析。

安装步骤

  1. 克隆仓库: 
    git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
  2. 构建并安装服务器: 
    uv build
uv pip install .
    请确保您的开发环境中已安装 Python 和 uv (或 pip)。uvbuild 和 uv pip 是推荐的 Python 包管理工具，您也可以使用 pip 代替。

服务器配置 (用于 MCP 客户端，例如 Claude)

要将 Coin MCP Server 集成到支持 MCP 协议的客户端 (例如 Claude 应用)，您需要在客户端的 MCP 服务器配置中添加以下信息。以下是 Claude 应用的配置示例，其他 MCP 客户端的配置方式可能略有不同，请参考相应的客户端文档。

{
  "mcpServers": {
    "coin_api": {
      "command": "python",
      "args": ["-m", "coin_api_mcp"]
    }
  }
}

配置说明:

  • '"server name"': 'coin_api' (服务器名称，用于在客户端中唯一标识和调用此服务器)
  • '"command"': '"python"' (启动服务器的命令，指定使用 python 解释器来运行服务器)
  • '"args"': '["-m", "coin_api_mcp"]' (传递给 python 命令的参数，'-m coin_api_mcp' 参数告诉 Python 运行 'coin_api_mcp' 模块作为主程序)

重要: Coin MCP Server 依赖 CoinMarketCap API 密钥才能正常工作。您需要在运行服务器之前配置 API 密钥。

设置 API 密钥: 您可以通过以下两种方式设置 CoinMarketCap API 密钥：

  1. 环境变量: 推荐使用环境变量方式。在您的操作系统环境中设置 'COINMARKETCAP_API_KEY' 环境变量，值为您的 API 密钥。例如，在 Linux 或 macOS 系统中，您可以使用 'export COINMARKETCAP_API_KEY=YOUR_COINMARKETCAP_API_KEY' 命令。在 Windows 系统中，您可以在系统环境变量设置中添加。
  2. 命令行参数: 您也可以在启动服务器时，通过命令行参数 '--api-key' 来指定 API 密钥。例如：'python -m coin_api_mcp --api-key=YOUR_COINMARKETCAP_API_KEY'。

建议优先使用环境变量方式配置 API 密钥，以提高安全性并避免在配置文件或命令行中直接暴露敏感信息。

基本使用方法

  1. 启动服务器: 根据您选择的配置方式 (环境变量或命令行参数) 设置 API 密钥后，启动 Coin MCP Server。如果您使用环境变量配置 API 密钥，只需在终端中运行命令：

    python -m coin_api_mcp

  2. 配置 MCP 客户端: 将上述服务器配置 JSON 代码添加到您的 MCP 客户端 (例如 Claude) 的 MCP 服务器配置文件中。具体的配置文件位置和编辑方式请参考您的 MCP 客户端的文档。

  3. 在 MCP 客户端中使用工具: 启动 MCP 客户端后，您就可以在客户端中使用 Coin MCP Server 提供的工具来查询加密货币数据了。您可以使用以下工具名称在客户端中发起请求：

    • 'listing-coins' (获取加密货币列表)
    • 'get-coin-info' (获取加密货币信息)
    • 'get-coin-quotes' (获取加密货币报价)

    工具的具体调用方式和参数设置取决于您使用的 MCP 客户端。请查阅您所用 MCP 客户端的帮助文档，了解如何通过自然语言指令或界面操作来调用和使用这些工具。

信息

分类

网页与API

访问项目