用途
newsagent-mcp 是 NewsAgent Data API 的 MCP（Model Context Protocol）服务器，用于让 AI 智能体（如 Claude Desktop、Cursor、Cline 等）直接查询已评分、已分类的俄语与英语新闻情报。它主要面向需要新闻监测、舆情分析或事件追踪的 AI 应用场景。
主要能力
服务器封装了 NewsAgent Data API，返回的每篇文章都已具备以下预处理结果：
- 紧急程度评分（0–10）
- 政治倾向分类
- 话题分类
- 国家分类
- 受众分类
- 去重处理
由于结果已预评分与预分类，用户侧无需再自行构建 NLP 流水线。文档提到服务器提供五个工具（five tools），接入后自动出现。示例提示词包括：获取俄罗斯评分 7 及以上的突制裁新闻；搜索最近 14 天内“央行利率”的英文新闻；使用 get_feed 配合 political_lean 比较国家媒体与反对派媒体对乌克兰的报道；查询实时覆盖的国家与来源数量。
使用方式
- 获取免费 API Key：https://newsagentdata.com/signup/?plan=free
- 安装依赖：
pip install -r requirements.txt - 在 MCP 客户端配置中添加服务器：Claude Desktop 使用 claude_desktop_config.json；Cursor / Cline 则将 MCP 服务器命令指向 newsagent_mcp.py，并在环境变量中设置 NEWSAGENT_API_KEY。
- 重启客户端，五个工具会自动出现。
可通过设置环境变量 NEWSAGENT_API_BASE 覆盖 API 主机地址（默认 https://api.newsagentdata.com ）。
适用场景
- 突发新闻监测：按紧急程度评分筛选高优先级新闻。
- 舆情与政治倾向分析：比较不同政治倾向来源对同一事件的报道。
- 多语言新闻检索：支持俄语与英语。
- 多国事件追踪：按国家、话题、受众等维度过滤。
- 实时覆盖统计：查询当前覆盖的国家数和来源数。
限制
- 免费/开发者层级有历史窗口限制（1–7 天）和每日配额。
- 服务器会将 401/403/429 状态码以清晰错误形式返回。
- list_sources 工具需要 Standard 层级密钥；频道 handle 永不暴露。
- 具体的五个工具名称、参数细节、层级价格与配额数值，资料中暂未提供。
