项目简介
'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 客户端集成。
安装步骤
- 克隆仓库: 将 'cryptopanic-mcp-server' 仓库克隆到本地。
git clone https://github.com/kukapay/cryptopanic-mcp-server cd cryptopanic-mcp-server - 安装依赖 (可选): 虽然示例中没有明确的依赖安装步骤,但如果 'fastmcp' 不是标准库,可能需要安装。通常 Python 项目会使用 'pip install -r requirements.txt' 安装依赖,但此仓库没有 'requirements.txt' 文件。根据代码,可能需要确保安装了 'requests' 和 'python-dotenv' 库,但 'fastmcp' 可能是项目自定义的库 (实际上 'mcp.server.fastmcp' 在标准库或常见库中不存在,这里可能是为了示例目的的简化表示,或者是一个未公开的库)。 为了运行,可能需要安装 'requests' 和 'python-dotenv':
pip install requests python-dotenv - 配置 CryptoPanic API 密钥: 访问 CryptoPanic 开发者网站 获取 API 密钥。
- 设置环境变量: 创建 '.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' 文件进行配置,更加安全和方便。
基本使用方法
- 启动服务器: 在 MCP 客户端中配置好服务器信息后,启动 'cryptopanic-mcp-server'。MCP 客户端会根据配置的命令和参数启动服务器进程。
- Agent 调用工具: 在你的 AI Agent 中,可以使用配置的服务器名称 'cryptopanic-mcp-server' 和工具名 'get_crypto_news' 来调用该工具。例如,Agent 可以指示 MCP 客户端调用 'cryptopanic-mcp-server.get_crypto_news' 工具,并传递参数如 'kind="news"' 和 'num_pages=3' 来获取 3 页的新闻内容。
- 获取新闻信息: 服务器会调用 CryptoPanic API 获取加密货币新闻,并将新闻标题列表以字符串形式返回给 Agent。Agent 可以解析返回的字符串,从中提取所需的新闻信息。
信息
分类
网页与API