TrendRadar MCP Server

关键词

新闻聚合跨平台通知数据查询情感分析趋势分析

使用说明（Markdown 格式）

  • 项目简介 TrendRadar 提供一个基于 MCP（Model Context Protocol）的后端服务器，聚合新闻热点数据、提供数据查询和分析工具，以及支持对话式 AI 分析能力。服务器以 MCP 协议为接口，向不同的 MCP 客户端暴露工具集（如获取最新新闻、按日期检索、趋势分析、情感分析、相似新闻等），并可通过多种传输模式（STDIO、HTTP，便于本地集成或云端部署）与 LLM 客户端对接。

  • 主要功能点

    1. MCP 服务器核心：支持 STDIO 与 HTTP 传输，统一通过 FastMCP 2.0 提供工具服务。
    2. 数据与工具集合：实现数据查询、趋势分析、情感分析、新闻检索、关键词分析、文本生成提示等多类工具。
    3. 认证与安全：提供基于密码的 HTTP 认证中间件，保护敏感工具的访问。
    4. 多渠道通知与报告：内置多渠道推送（飞书、钉钉、企业微信、Telegram、邮件、ntfy、Bark、Slack 等）并支持分批推送与时间窗口控制。
    5. 报告与可视化：生成 HTML 报告、图表及嵌入式趋势分析，便于通过 MCP 客户端查看。
    6. 客户端互操作性：提供多种 MCP 客户端接入方式的示例配置，方便在 Claude、Cursor、Cline 等环境中调用。

  • 安装步骤

    1. 准备运行环境：确保已安装 Python3，推荐在虚拟环境中执行。
    2. 获取源码：克隆 TrendRadar 仓库并进入项目根目录。
    3. 依赖安装：安装运行所需依赖（如 FastMCP、Requests、PyYAML 等）。具体依赖请参考项目需求与安装文档。
    4. 启动 MCP 服务器：
      • 通过命令行直接启动（示例，具体参数可按需要调整）：
        • 传输模式 STDIO：python -m mcp_server.server --transport stdio
        • 传输模式 HTTP：python -m mcp_server.server --transport http --host 0.0.0.0 --port 3333
      • 启动后服务器会暴露 MCP 服务，客户端可通过对应传输模式进行连接。
    5. 客户端接入前提（见下方配置示例）：
      • 客户端需按 MCP 客户端要求配置服务器连接信息（名称、传输模式、地址等）。

  • 服务器配置（MCP 客户端连接 TrendRadar 的示例信息） 说明：以下为 JSON 格式的服务器配置描述，包含服务器名称、启动命令、参数等信息，供 MCP 客户端在本地或远程环境中配置连接使用。实际部署时，请将路径替换为你的部署目录。

    { "server_name": "trendradar", "transport": "stdio", "command": "uv", "args": [ "--directory", "/path/to/TrendRadar", "run", "python", "-m", "mcp_server.server" ], "notes": "标准输入输出模式，客户端通过 MCP 协议与本服务器交互。若需改用 HTTP，请将 transport 设为 http，并设置 host/port，路径通常为 /mcp。" }

    客户端也可按需要改为 HTTP 连接： { "server_name": "trendradar", "transport": "http", "host": "0.0.0.0", "port": 3333, "path": "/mcp", "description": "通过 HTTP 协议提供 MCP 接口，适合云端部署或需要网络访问的场景。" }

  • 基本使用方法

    1. 启动后，MCP 客户端可以通过以下方式连接服务器，进行资源查询、工具调用和分析任务：
      • STDIO 模式：通过本地集成环境以标准输入/输出进行交互
      • HTTP 模式：通过 HTTP 请求向 /mcp 端点发送 JSON-RPC 请求
    2. 常见操作流程
      • 选择需要的 MCP 工具（如 get_latest_news、get_news_by_date、analyze_topic_trend、search_news 等）进行数据查询、分析或检索。
      • 客户端可通过返回的 JSON 结果解析新闻列表、趋势统计、情感分析提示等信息。
      • 如需进行跨客户端协作，确保授权与传输方式在客户端和服务器端保持一致。
    3. 客户端示例（简要说明，不包含代码实现）
      • 在 Claude/Cursor 等环境中配置 MCP 服务地址、传输方式、以及工具调用入口。
      • 使用服务器端的工具名称和返回数据结构进行后续的对话或决策支持。

  • 重要说明

    • 服务器内置多种通知与报告能力，默认可通过配置开启或关闭。请在 config.yaml 中设置推送渠道及开启条件。
    • MCP 服务器底层实现对数据、分析、和通知的支持都在 mcp_server 目录中，包含数据查询、分析、配置管理、系统管理等工具模块，具备较完整的生产级能力。

以上内容用于帮助你快速理解与接入 TrendRadar 的 MCP 服务器实现。

服务器信息

访问项目