TrendRadar MCP 服务器（FastMCP 2.0 实现）

关键词

新闻分析新闻聚合AI分析数据查询多客户端

使用说明（简要概览，便于快速上手）

  • 项目简介 TrendRadar MCP 服务器是一套基于 MCP（Model Context Protocol）的后端服务，面向 LLM 客户端提供标准化的上下文信息和功能。核心能力包括：托管并管理新闻资源、注册并执行工具、定义和渲染 Prompt 模板，以及通过 JSON-RPC 与客户端通信，支持多传输模式（STDIO、HTTP）。同时内置认证、会话管理、以及丰富的数据查询和分析工具，方便进行多客户端协同分析。

  • 主要功能点

    • MCP 服务端实现：基于 FastMCP 2.0，支持 stdio 与 http 两种传输模式，生产环境可通过 HTTP 提供端点。
    • 资源与工具：提供新闻数据的查询、趋势分析、关键词筛选、情感分析、相似新闻、摘要报告等多种工具接口。
    • 数据与分析能力：整合 TrendRadar 的数据服务，支持多平台新闻源、关键词配置、热度权重、以及报警/推送等能力。
    • 安全与会话：提供基于 Bearer Token 的认证中间件，HTTP 模式以密码方式进行简单鉴权。
    • 配置与扩展：通过 config/config.yaml 与环境变量进行全面配置，支持缓存、代理、推送渠道等。
    • 多客户端集成：提供 MCP 客户端接入示例与工具描述，包含 Claude/Cursor/Cherry Studio 等客户端的对接方式（HTTP/STDIO 模式）。
    • 数据持久化与缓存：内置缓存服务与数据服务，支持将抓取结果导出为 TXT/HTML 报告并持久化输出。

  • 安装与运行步骤

    1. 获取源码：将 TrendRadar 仓库完整克隆到本地或服务器。
    2. 安装依赖：确保 Python 环境就绪，按需求安装外部依赖（如 fastmcp、requests、yaml 等）。
    3. 配置文件准备：在 config 目录下准备 config.yaml 与 frequency_words.txt，配置新闻平台、推送渠道、关键词等。
    4. 启动 MCP 服务：
      • STDIO 传输模式：通过 MCP 客户端以 stdio 方式连接，服务器以标准输入输出进行通信。
      • HTTP 传输模式：通过 HTTP 端点提供 JSON-RPC 服务，默认监听 0.0.0.0:3333，受限时可通过配置修改。
    5. 连接 MCP 客户端：根据所选客户端的要求，使用以下示例配置启动连接（下方给出可直接使用的服务器配置 JSON 示意，便于 MCP 客户端理解如何连接）。
    6. 验证与测试：可使用 SSL/TLS/Bearer Token 的方式对接，结合 test_authentication.py 等简单测试用例检查访问权限与接口返回。

  • 服务器配置与客户端连接信息（MCP 客户端需要的最小连接信息） 服务器名称: trendradar-news 启动命令示例（JSON 配置，描述性注释如下，实际在客户端中使用时以该结构为准） { "server_name": "trendradar-news", "command": "uv", "args": [ "--directory", "/path/to/TrendRadar", "run", "mcp_server.server" ], "description": "TrendRadar MCP 服务器，使用 FastMCP 2.0，提供 STDIO/HTTP 两种传输。" } 注释说明：

    • server_name：在 MCP 客户端侧识别的服务器名称，示例值为 TrendRadar 的 MCP 服务实例名 trendradar-news，与服务器端注册的一致性用于区分不同 MCP 服务。
    • command / args：启动 MCP 服务的执行命令及参数。这里采用公共易用的 UV 启动方式，Directory 指向 TrendRadar 项目根目录，后续通过 mcp_server.server 提供 MCP 服务入口。
    • 传输模式：可以在客户端配置中选择 stdio 或 http（HTTP 模式下将暴露 /mcp 端点，便于远程调用）。
    • 注：MCP 客户端不需要额外的代码实现，直接通过配置连接即可；服务器端提供了完整的工具集和数据访问能力。

  • 基本使用方法

    • 选择传输模式：STDIO（本地/嵌入式客户端）或 HTTP（对外暴露端点）。
    • 启动后，通过 MCP 客户端加载 trendradar-news 服务，调用工具接口获取新闻数据、执行分析、或获取当前配置等。
    • 如需对接文件输出、历史数据对比等，确保 config.yaml 指向正确的输出目录，且 output 目录有可用数据。
    • 如需对接多渠道推送，请在配置中启用相应的 webhook（飞书、钉钉、企业微信、Telegram、邮件、ntfy、Bark、Slack 等）。
    • 认证与安全：若使用 HTTP 模式，请设置 MCP_SERVER_PASSWORD 环境变量，客户端在访问时通过 Bearer token 进行认证。

  • 关键词 新闻分析, 新闻聚合, AI分析, 数据查询, 多客户端

  • 分类ID 6

服务器信息

访问项目