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 响应结构。
- 监控与维护:通过日志、版本检查、以及可选的推送渠道监控服务状态,必要时重启服务或重新配置环境变量。