项目简介

这是一个基于 Model Context Protocol (MCP) 实现的服务器,专门用于为大型语言模型(LLM)客户端提供加密货币相关的实时新闻信息。它集成 Newsdata.io API,将外部数据源转化为LLM可用的结构化工具和上下文。

主要功能点

  • 最新新闻头条工具: 获取当前最新的加密货币新闻标题及其发布日期。
  • 加密新闻搜索工具: 根据指定的加密货币名称或关键词搜索相关新闻文章,支持分页获取更多结果。
  • 新闻摘要 Prompt 模板: 提供一个可重用的Prompt模板,结合搜索工具的结果,引导LLM对特定主题的加密新闻进行总结。

安装步骤

  1. 获取 API Key: 前往 Newsdata.io 注册并获取您的 API Key。
  2. 克隆仓库:
    git clone https://github.com/kukapay/crypto-news-mcp.git
    cd crypto-news-mcp
  3. 安装依赖:
    pip install mcp[cli] httpx python-dotenv
  4. 配置 API Key: 在项目根目录下创建一个 '.env' 文件,并添加您的 Newsdata.io API Key:
    NEWS_API_KEY="您的_Newsdata_API_Key"
    请将 '"您的_Newsdata_API_Key"' 替换为您实际获取的 Key。

服务器配置 (供 MCP 客户端使用)

该服务器作为 MCP 客户端的外部工具和上下文提供者运行。您需要在您的 MCP 客户端(如 Claude Desktop 或其他兼容客户端)中添加对此 MCP 服务器的引用。

典型的配置需要指定以下信息:

  • 服务器名称 (Server Name): 您希望在客户端中显示的服务器名称,例如 '"Crypto News"'。
  • 启动命令 (Command): 运行服务器脚本的命令,通常是 '"python"'。
  • 启动参数 (Args): 传递给启动命令的参数,即服务器主脚本的路径。例如,如果脚本在 'main.py',参数就是 '["path/to/your/crypto-news-mcp/main.py"]'。请将 'path/to/your/crypto-news-mcp' 替换为实际的项目路径。
  • 环境变量 (Environment Variables): 服务器运行所需的环境变量,必须包含 'NEWS_API_KEY' 及其值。例如:'{"NEWS_API_KEY": "您的_Newsdata_API_Key"}'。

具体配置方式请参考您所使用的 MCP 客户端的文档。

基本使用方法 (通过 MCP 客户端与LLM交互)

配置完成后,您的 LLM 客户端将能够发现并使用该 MCP 服务器提供的功能。在与 LLM 交互时,您可以:

  • 调用工具:
    • 请求 LLM 调用 'get_latest_news' 工具以获取最新新闻头条。
    • 请求 LLM 调用 'get_crypto_news' 工具,并提供 'query' 参数(如 "bitcoin")和可选的 'max_pages' 参数,以搜索特定新闻。
  • 使用 Prompt 模板:
    • 要求 LLM 使用 'summarize_news' Prompt 模板,并提供 'query' 参数,该模板会自动触发新闻搜索工具,并将结果作为上下文提供给 LLM 进行总结。

具体的调用语法取决于您的 MCP 客户端如何集成和展示 MCP 工具及 Prompt。通常,LLM会通过客户端代理以结构化的方式调用这些功能。

信息

分类

网页与API