TrendRadar MCP 服务器

  • 项目简介

    • TrendRadar 的 MCP 服务器实现了基于 MCP 的后端服务,提供数据查询、跨平台分析、以及对话式 AI 分析的能力,帮助 LLM 客户端以标准化方式访问新闻资源、工具和分析结果。
  • 主要功能点

    • 数据查询与资源管理:提供最新新闻、按日期查询、趋势话题等资源访问接口。
    • 高级数据分析工具:趋势分析、平台对比、关键词共现、情感分析、相似新闻查找、摘要生成等。
    • MCP 客户端支持:通过标准 MCP 协议暴露多种工具接口,支持不同客户端(如 Claude、Cursor、VSCode 插件等)接入和调用。
    • 多传输协议:支持标准 MCP over stdio 与 MCP over HTTP,便于本地开发和生产环境部署。
    • AI 分析能力整合:提供基于新闻数据的对话式分析入口,输出可直接供 AI 模型消费的提示词和结构化结果。
    • 配置与运维:包含数据源、推送、权重配置、日期解析、缓存、以及简单的容器化运维支持。
  • 安装与运行

    • 本项目的 MCP 服务端代码位于 mcp_server 目录,核心服务通过 FastMCP 2.0 实现,启动时可选择 stdio 或 http(默认 stdio)。
    • 运行前需准备数据输出目录(TrendRadar 的抓取与输出逻辑),并确保 config/config.yaml 配置正确。
    • 常用运行方式:在命令行直接启动 MCP 服务器进程,通过 stdio 与 MCP 客户端通信,或通过 HTTP 端点提供服务。
  • 服务器配置(MCP 客户端连接信息描述,非可执行代码说明)

    • server name(服务器标识,用于 MCP 客户端注册):trendradar
    • command(启动命令):uv
    • args(启动参数,数组形式,逐项含义如下)
      • --directory: 指向 TrendRadar 项目根目录的绝对路径,例如 /path/to/TrendRadar
      • run: 指示开启服务器执行模式
      • python: 使用 Python 解释器执行
      • -m: 指定模块路径
      • mcp_server.server: MCP 服务端入口模块
    • env(环境变量字典,可选,默认空)
    • disabled(是否禁用,布尔值,默认 false)
    • alwaysAllow(额外允许的客户端标识列表,默认空列表)
    • 说明:上述配置来自仓库提供的 MCP 客户端接入示例,确保客户端能够通过 FastMCP 2.0 规范与服务器建立连接。MCP 客户端无需任何特定代码,客户端通过读取该配置启动并与服务器通信即可。
  • 基本使用方法

    • 启动:在支持 MCP 的客户端中按上述配置启动后,MCP 服务器将通过标准输出/输入或 HTTP 端点对外暴露工具接口。
    • 调用:客户端可以通过 MCP 协议调用工具,例如获取最新新闻、日期新闻、进行趋势分析等;服务器返回标准的 JSON-RPC 响应结构。
    • 监控与维护:通过日志、版本检查、以及可选的推送渠道监控服务状态,必要时重启服务或重新配置环境变量。

服务器信息