TrendRadar MCP 服务器

使用说明(Markdown 格式)

  • 项目简介

    • TrendRadar MCP 服务器是 TrendRadar 项目的服务器端实现,遵循 Model Context Protocol(MCP)标准,提供向 MCP 客户端暴露的新闻资源、查询工具、分析能力和自动化报告能力。服务支持两种传输模式:stdio(标准输入输出)和 http(HTTP API)。通过 MCP 客户端可读取新闻资源、执行分析、调用数据查询工具等。
  • 主要功能点

    • MCP 核心功能
      • 支持通过 MCP 协议向客户端暴露一组工具,包含数据查询、搜索、分析、系统管理等模块。
      • 提供多客户端接入能力,允许通过不同 MCP 客户端进行对话式分析、数据检索和报告获取。
    • 资源与工具
      • 提供新闻数据资源的查询接口(最新、按日期、趋势等)。
      • 提供新闻检索、关键词分析、话题趋势分析、数据洞察等高级分析工具。
    • Prompts 与渲染
      • 针对分析结果,生成结构化的提示信息,方便将结果交给 AI 客户端进行进一步推理或对话。
    • 传输模式
      • stdio:适合直接在同一进程内的客户端调用。
      • http:对外暴露一个生产环境的 API 端点,便于远端 MCP 客户端接入。
    • 兼容与扩展
      • 与 TrendRadar 的其他模块(数据获取、HTML 报告生成、Webhook 推送等)解耦,具备清晰的模块边界,便于扩展新的工具或分析能力。
  • 安装与运行步骤

    • 环境准备
      • Python 3.x 及以上环境
      • 依赖库包括但不限于 fastmcp、yaml、requests 等,请按项目需求安装依赖
    • 安装方式
      • 将 TrendRadar MCP 服务代码获取到本地,或在容器中部署
    • 启动服务器
      • 生产环境(HTTP)启动示例:
        • 运行命令:python -m mcp_server.server --transport http --host 0.0.0.0 --port 3333 --project-root /path/to/TrendRadar
      • 本地开发或测试(stdio)启动示例:
        • 运行命令:python -m mcp_server.server --transport stdio --project-root /path/to/TrendRadar
    • 客户端连接配置(非必需代码块,仅作为配置说明)
      • MCP 客户端不需要 TrendRadar 代码;仅需了解以下启动信息以便接入:
        • 服务器名称(server name):trendradar-news
        • 启动命令及参数(示例如下,用于 MCP 客户端的连接配置注释)
        • 传输模式选择(stdio 或 http)
    • MCP 客户端配置(注:下面信息为参考性描述,不需要在 MCP 客户端插入真实代码)
      • JSON 配置示例(用于 MCP 客户端的连接描述,按需填写): { "server_name": "trendradar-news", "transport": "http", "host": "0.0.0.0", "port": 3333, "project_root": "/path/to/TrendRadar" } 注释说明:server_name 为 MCP 服务端标识,transport 指定传输模式,host/port 为 HTTP 服务监听地址与端口,project_root 指向 TrendRadar 项目根目录。
  • 基本使用方法

    • 连接与请求
      • 向 MCP 客户端发送请求以读取资源、执行数据查询、发起分析等操作,服务端返回 MCP 格式的响应数据。
    • 常用工具类别
      • 数据查询与读取:获取最新新闻、按日期查询、按关键词检索等
      • 高级分析:话题趋势、数据洞察、情感分析、相似新闻、摘要报告
      • 系统与配置:获取当前配置、系统状态、触发爬虫等
    • 使用注意
      • MCP 客户端与服务器的版本对齐,确保方法名称与参数符合 MCP 2.0 的实现
      • 若使用 HTTP 传输,注意网络防火墙和端口配置

服务器信息