TrendRadar MCP Server

使用说明内容（Markdown格式）

• 项目简介

  • TrendRadar MCP Server 是一个完整的 MCP 服务器实现，采用 FastMCP 2.0 协议，提供多类 MCP 工具（如数据查询、趋势分析、搜索、系统配置等），并能将结果以结构化的 JSON 形式返回给 MCP 客户端。服务器设计目标是为 LLM 客户端提供可扩展、可安全接入的新闻数据、分析能力和自动化工作流。

• 主要功能点

  • MCP 标准实现：支持 MCP over stdio 和 MCP over HTTP 的传输模式，提供统一的工具暴露入口。
  • P0 与 P1 级工具组合：数据获取与查询（最新新闻、按日查询、按关键词搜索等）、跨平台情感与趋势分析、主题趋势预测、新闻相似性检索等。
  • 本地数据源接入与缓存：通过本地 output 目录读取 TXT/HTML 数据，提供缓存以提升性能。
  • AI 相关能力：集成用于生成 AI 提示词的分析工具、支持对话式分析流程（日期解析、趋势分析等）。
  • 客户端接入示例友好：提供 Claude Desktop、Cursor、Cline、Claude 等 MCP 客户端的连接方式和示例配置。
  • 传输与部署灵活性：可在容器或本地环境中以 stdio 或 HTTP 方式运行，便于在不同部署场景快速接入。

• 安装步骤（简明）

  • 准备环境：需具备 Python 3.x 环境。
  • 获取代码：将 TrendRadar 的代码仓克隆或下载到本地。
  • 依赖安装（示例，不给出逐行命令）：安装 FastMCP、PyYAML、Requests 等运行依赖。
  • 启动服务器（两种模式任选其一）：
    • STDIO 模式：执行命令运行服务器服务，供 MCP 客户端以 STDIO 方式连接。
    • HTTP 模式：启动 HTTP 服务，客户端通过网络请求访问，默认监听 0.0.0.0:3333。
  • 服务器启动参数（必选项，具体可通过 CLI 帮助获取）：
    • transport: stdio 或 http
    • host: 监听地址（HTTP 模式使用）
    • port: 监听端口（HTTP 模式使用）
    • project-root: 项目根目录（可选，用于定位 data、config 等资源）

• 服务器配置（MCP 客户端必需的连接信息描述，JSON 形式说明）

  • 服务器名称（server name）：trendradar-news
  • 启动命令（command）：python
  • 运行参数（args）：-m mcp_server.server --transport stdio --project-root /path/to/TrendRadar
  • 说明：该配置用于 MCP 客户端建立连接并调用 TrendRadar 提供的工具与查询能力。实际使用中客户端可选使用 stdio 或 http 传输模式，服务器会按该模式暴露相应的 MCP 接口。

• 基本使用方法

  • 启动后，MCP 客户端可以调用以下核心工具与接口：resolve_date_range、get_latest_news、get_news_by_date、get_trending_topics、analyze_topic_trend、analyze_sentiment、generate_summary_report、search_news 等等。
  • 客户端使用流程大致为：请求日期解析、查询新闻数据、执行分析工具、获取并处理结果（HTML/Markdown/JSON）并可触发汇总报告或新增新闻等。
  • 如需快速体验，可直接使用示例客户端，连接后按文档提供的工具调用方式执行对应任务。