TrendRadar MCP 服务器
使用说明(Markdown 格式)
-
项目简介
- TrendRadar MCP 服务器是 TrendRadar 项目的服务器端实现,遵循 Model Context Protocol(MCP)标准,提供向 MCP 客户端暴露的新闻资源、查询工具、分析能力和自动化报告能力。服务支持两种传输模式:stdio(标准输入输出)和 http(HTTP API)。通过 MCP 客户端可读取新闻资源、执行分析、调用数据查询工具等。
-
主要功能点
- MCP 核心功能
- 支持通过 MCP 协议向客户端暴露一组工具,包含数据查询、搜索、分析、系统管理等模块。
- 提供多客户端接入能力,允许通过不同 MCP 客户端进行对话式分析、数据检索和报告获取。
- 资源与工具
- 提供新闻数据资源的查询接口(最新、按日期、趋势等)。
- 提供新闻检索、关键词分析、话题趋势分析、数据洞察等高级分析工具。
- Prompts 与渲染
- 针对分析结果,生成结构化的提示信息,方便将结果交给 AI 客户端进行进一步推理或对话。
- 传输模式
- stdio:适合直接在同一进程内的客户端调用。
- http:对外暴露一个生产环境的 API 端点,便于远端 MCP 客户端接入。
- 兼容与扩展
- 与 TrendRadar 的其他模块(数据获取、HTML 报告生成、Webhook 推送等)解耦,具备清晰的模块边界,便于扩展新的工具或分析能力。
- MCP 核心功能
-
安装与运行步骤
- 环境准备
- Python 3.x 及以上环境
- 依赖库包括但不限于 fastmcp、yaml、requests 等,请按项目需求安装依赖
- 安装方式
- 将 TrendRadar MCP 服务代码获取到本地,或在容器中部署
- 启动服务器
- 生产环境(HTTP)启动示例:
- 运行命令:python -m mcp_server.server --transport http --host 0.0.0.0 --port 3333 --project-root /path/to/TrendRadar
- 本地开发或测试(stdio)启动示例:
- 运行命令:python -m mcp_server.server --transport stdio --project-root /path/to/TrendRadar
- 生产环境(HTTP)启动示例:
- 客户端连接配置(非必需代码块,仅作为配置说明)
- MCP 客户端不需要 TrendRadar 代码;仅需了解以下启动信息以便接入:
- 服务器名称(server name):trendradar-news
- 启动命令及参数(示例如下,用于 MCP 客户端的连接配置注释)
- 传输模式选择(stdio 或 http)
- MCP 客户端不需要 TrendRadar 代码;仅需了解以下启动信息以便接入:
- MCP 客户端配置(注:下面信息为参考性描述,不需要在 MCP 客户端插入真实代码)
- JSON 配置示例(用于 MCP 客户端的连接描述,按需填写): { "server_name": "trendradar-news", "transport": "http", "host": "0.0.0.0", "port": 3333, "project_root": "/path/to/TrendRadar" } 注释说明:server_name 为 MCP 服务端标识,transport 指定传输模式,host/port 为 HTTP 服务监听地址与端口,project_root 指向 TrendRadar 项目根目录。
- 环境准备
-
基本使用方法
- 连接与请求
- 向 MCP 客户端发送请求以读取资源、执行数据查询、发起分析等操作,服务端返回 MCP 格式的响应数据。
- 常用工具类别
- 数据查询与读取:获取最新新闻、按日期查询、按关键词检索等
- 高级分析:话题趋势、数据洞察、情感分析、相似新闻、摘要报告
- 系统与配置:获取当前配置、系统状态、触发爬虫等
- 使用注意
- MCP 客户端与服务器的版本对齐,确保方法名称与参数符合 MCP 2.0 的实现
- 若使用 HTTP 传输,注意网络防火墙和端口配置
- 连接与请求