项目简介

'cryptopanic-mcp-server' 是一个实现了 Model Context Protocol (MCP) 的服务器,旨在为 AI Agent 提供实时的加密货币市场新闻。它通过集成的 'get_crypto_news' 工具,允许 Agent 获取来自 CryptoPanic API 的新闻、分析文章和视频,帮助 Agent 理解市场动态和相关信息。

主要功能点

  • 提供加密货币新闻工具: 通过 'get_crypto_news' 工具,Agent 可以轻松获取最新的加密货币新闻。
  • 支持多种新闻类型: 工具支持获取新闻、分析和视频等不同类型的内容。
  • 可配置页数: 允许 Agent 控制获取的新闻页数,从而控制信息量。
  • 基于标准 MCP 框架: 使用 'fastmcp' 库构建,遵循 MCP 协议,易于与 MCP 客户端集成。

安装步骤

  1. 克隆仓库: 将 'cryptopanic-mcp-server' 仓库克隆到本地。
    git clone https://github.com/kukapay/cryptopanic-mcp-server
    cd cryptopanic-mcp-server
  2. 安装依赖 (可选): 虽然示例中没有明确的依赖安装步骤,但如果 'fastmcp' 不是标准库,可能需要安装。通常 Python 项目会使用 'pip install -r requirements.txt' 安装依赖,但此仓库没有 'requirements.txt' 文件。根据代码,可能需要确保安装了 'requests' 和 'python-dotenv' 库,但 'fastmcp' 可能是项目自定义的库 (实际上 'mcp.server.fastmcp' 在标准库或常见库中不存在,这里可能是为了示例目的的简化表示,或者是一个未公开的库)。 为了运行,可能需要安装 'requests' 和 'python-dotenv':
    pip install requests python-dotenv
  3. 配置 CryptoPanic API 密钥: 访问 CryptoPanic 开发者网站 获取 API 密钥。
  4. 设置环境变量: 创建 '.env' 文件在仓库根目录下,并添加以下内容,将 'YOUR_API_KEY' 替换为你自己的 API 密钥。
    CRYPTOPANIC_API_KEY=YOUR_API_KEY

服务器配置

以下 JSON 配置信息用于 MCP 客户端配置 'cryptopanic-mcp-server' 服务器。你需要将以下配置添加到你的 MCP 客户端的服务器配置中。

{
  "cryptopanic-mcp-server": {  // 服务器名称,客户端用此名称引用
    "command": "uv",  // 启动命令,这里使用 uv (假设 uv 是一个可用的 Python 运行器,例如 uvicorn 的快捷方式,或者用户需要根据实际情况调整为 python 或其他 Python 运行器)
    "args": [  // 启动参数
      "--directory", "/path/to/cryptopanic-mcp-server",  // 替换为 cryptopanic-mcp-server 仓库在您本地的实际路径
      "run",
      "main.py"
    ],
    "env": {  // 环境变量
      "CRYPTOPANIC_API_KEY": ""  //  这里无需填写 API 密钥,因为程序会从 .env 文件或系统环境变量中读取
    }
  }
}

注意:

  • 请将 '/path/to/cryptopanic-mcp-server' 替换为克隆到本地的 'cryptopanic-mcp-server' 仓库的实际绝对路径。
  • 'command' 字段使用了 'uv',这可能需要用户根据自己的环境进行调整。常用的 Python 运行命令可能是 'python' 或 'python3',或者使用 ASGI 服务器如 'uvicorn'。 如果使用 'python' 或 'python3',则 'args' 可以简化为 '["main.py"]',并确保当前工作目录是仓库根目录。
  • API 密钥通过环境变量 'CRYPTOPANIC_API_KEY' 传递,建议使用 '.env' 文件进行配置,更加安全和方便。

基本使用方法

  1. 启动服务器: 在 MCP 客户端中配置好服务器信息后,启动 'cryptopanic-mcp-server'。MCP 客户端会根据配置的命令和参数启动服务器进程。
  2. Agent 调用工具: 在你的 AI Agent 中,可以使用配置的服务器名称 'cryptopanic-mcp-server' 和工具名 'get_crypto_news' 来调用该工具。例如,Agent 可以指示 MCP 客户端调用 'cryptopanic-mcp-server.get_crypto_news' 工具,并传递参数如 'kind="news"' 和 'num_pages=3' 来获取 3 页的新闻内容。
  3. 获取新闻信息: 服务器会调用 CryptoPanic API 获取加密货币新闻,并将新闻标题列表以字符串形式返回给 Agent。Agent 可以解析返回的字符串,从中提取所需的新闻信息。

信息

分类

网页与API