AI导哈

AI新闻聚合服务

NewsMCP是一个为AI代理提供实时新闻事件聚合的服务，通过AI从数百个来源中聚类新闻，并按主题和地理位置分类，按重要性排序。

  • by pranciskus
  • TypeScript
  • 本地部署
  • 35 星标
  • 更新于
在 GitHub 查看 pranciskus/newsmcp

使用说明

NewsMCP — World news for AI agents

newsmcp.io  •  integrations  •  REST API

实时新闻事件，由人工智能从数百个来源聚类，按主题和地理位置分类，按重要性排序。

免费。没有API密钥。一个安装命令。

覆盖

12主题 — politics economy technology science health environment sports culture crime military education society

30个地区 --6大洲24个国家。筛选依据 europe, asia, united-states, germany, japan, ukraine以及更多。

数百个来源 --文章按来源数量和影响评分实时分组到事件中。

集成

平台 软件包 安装
克劳德桌面版 @newsmcp/server MCP配置
Claude代码插件 newsmcp /plugin install
克劳德代码MCP @newsmcp/server claude mcp add
光标 @newsmcp/server MCP配置
帆板运动 @newsmcp/server MCP配置
OpenAI Codex @newsmcp/server codex mcp add
双子星命令行工具 @newsmcp/server settings.json
开源代码 @newsmcp/server opencode mcp add
铁匠铺 @newsmcp/server npx @smithery/cli
OpenClaw插件 @newsmcp/openclaw openclaw plugins install
开爪技能 newsmcp-skill clawhub install
REST API — curl https://newsmcp.io/v1/news/

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

Claude代码插件

/plugin marketplace add pranciskus/newsmcp
/plugin install newsmcp

克劳德代码MCP

claude mcp add newsmcp -- npx -y @newsmcp/server

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

帆板运动

添加到MCP配置：

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

OpenAI Codex

codex mcp add newsmcp -- npx -y @newsmcp/server

或添加到 ~/.codex/config.toml:

[mcp_servers.newsmcp]
command = "npx"
args = ["-y", "@newsmcp/server"]

双子星命令行工具

添加 ~/.gemini/settings.json （或项目本地 .gemini/settings.json):

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

开源代码

opencode mcp add

或添加到 ~/.config/opencode/opencode.json （或项目本地 .opencode/opencode.json):

{
  "mcp": {
    "newsmcp": {
      "type": "local",
      "enabled": true,
      "command": ["npx", "-y", "@newsmcp/server"]
    }
  }
}

铁匠铺

npx -y @smithery/cli install @newsmcp/server --client claude

OpenClaw插件

openclaw plugins install @newsmcp/openclaw

无需配置——开箱即用。看 @newsmcp/openclaw 选择。

开放式法律技能

clawhub install newsmcp-skill

轻量级替代方案-一个单一的SKILL.mod，教代理通过 curl。没有依赖关系。看 newsmcp-skill 上 爪集.

MCP工具

四个工具。这就是界面。

get_news

目前正在发生的重大事件。按主题、地区、时间窗口过滤。

参数 类型 默认值 说明
topics string -- 逗号分隔的主题段： politics,technology
geo string -- 逗号分隔的区域块： europe,lithuania
hours number 24 时间窗口（小时）（1–168）
page number 1 页码
per_page number 20 每页结果（最多50个）
order_by 字符串 -sources_count 排序字段（见下文）

排序选项: -sources_count, -impact_score, -last_seen_at, -entries_count （前缀 - 下降）

get_news_detail

单个事件的全部细节——所有源文章、人工智能生成的上下文、影响分析、实体标签。

参数 类型 说明
event_id string 事件UUID来自 get_news 结果

get_topics

列出可用于筛选的每个主题类别。无参数。

crime culture economy education environment health military politics science society sports technology

get_regions

列出可用于过滤的每个地理区域（6大洲和24个国家）。无参数。

代理商如何使用它

提示 发生了什么
“世界上发生了什么？” get_news 默认情况下--按源覆盖率列出的前20个事件
“今天欧洲有什么科技新闻吗？” get_news 随着 topics=technology, geo=europe, hours=24
“告诉我更多关于那次地震的信息” get_news_detail 带有事件UUID
“我可以根据哪些主题进行筛选？” get_topics --返回完整列表
“本周给我看亚洲新闻” get_news 随着 geo=asia, hours=168

REST API

不需要MCP？直接点击端点。相同的数据，相同的过滤器。

基础URL: https://newsmcp.io/v1

方法 端点 描述
GET /news/ 使用可选过滤功能列出新闻事件
GET /news/{id}/ 单次活动，包含完整文章列表
GET /news/topics/ 所有主题类别
GET /news/regions/ 所有地理区域

查询参数

所有参数都是可选的。自由组合。

# Latest events
curl -s https://newsmcp.io/v1/news/ | jq

# Filter by topic
curl -s "https://newsmcp.io/v1/news/?topics=technology" | jq

# Filter by region
curl -s "https://newsmcp.io/v1/news/?geo=europe" | jq

# Last 12 hours, sorted by impact
curl -s "https://newsmcp.io/v1/news/?hours=12&order_by=-impact_score" | jq

# Combine everything
curl -s "https://newsmcp.io/v1/news/?topics=politics&geo=united+states&hours=48&per_page=5" | jq

响应格式

{
  "events": [
    {
      "id": "cc3428ab-2ada-41bb-86ab-833fd39ffd8d",
      "summary": "Event description with AI-generated context...",
      "topics": ["technology", "politics"],
      "geo": ["united states"],
      "entries_count": 86,
      "sources_count": 45,
      "first_seen_at": "2026-02-15T04:06:41.728Z",
      "last_seen_at": "2026-03-03T05:00:30Z",
      "impact_score": 8,
      "entries": [
        {
          "title": "Article headline",
          "url": "https://source.com/article",
          "domain": "source.com",
          "published_at": "2026-03-03T05:00:30Z"
        }
      ]
    }
  ],
  "total": 142,
  "page": 1,
  "per_page": 20
}

运作原理

  1. 收集 --数百条新闻来源不断被抓取
  2. 簇 --关于同一事件的文章使用向量嵌入进行分组
  3. 分类 --每个事件都标记了主题和地理实体
  4. 排名 --事件按来源计数、影响和近期程度评分
  5. 服务 -通过REST API和MCP服务器清理JSON

随着新文章的出现，事件会实时更新。聚类AI会自动合并重复的覆盖范围。

配置

指向不同的API后端：

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"],
      "env": {
        "NEWS_API_BASE_URL": "https://your-api.example.com/v1"
      }
    }
  }
}

发布（GitHub操作+OIDC）

发布是通过标签驱动的 .github/workflows/release.yml:

  • 触发器：推标签 v*.*.*
  • 出版 @newsmcp/server 和 @newsmcp/openclaw 通过可信发布（OIDC）访问npm
  • 发布MCP元数据 mcp-publisher login github-oidc
  • 使用生成的笔记创建GitHub版本

一次性设置

  1. npm包设置： 对于 @newsmcp/server 和 @newsmcp/openclaw，添加一个受信任的发布者，指向：
    • 业主： pranciskus
    • 存储库： newsmcp
    • 工作流文件： .github/workflows/release.yml
    • 环境：留空（除非您有意使用）
  2. MCP注册表： 确保回购/包已授权在MCP注册表中发布GitHub OIDC。

释放流量

  1. 凹凸版本：
    • packages/mcp-server/package.json
    • packages/openclaw-plugin/package.json
    • packages/mcp-server/server.json
    • package-lock.json
  2. 承诺并推动 main
  3. 创建并推送标签：
git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z

工作流会自动执行发布和GitHub发布。

存储库结构

newsmcp/
├── .github/workflows/       # CI/CD workflows (release automation)
├── .claude-plugin/          # Marketplace manifest
├── packages/
│   ├── mcp-server/          # @newsmcp/server — MCP server (npm)
│   ├── claude-code-plugin/  # newsmcp — Claude Code plugin
│   ├── openclaw-plugin/     # @newsmcp/openclaw — OpenClaw plugin (npm)
│   └── skill/               # newsmcp-skill — OpenClaw skill (ClawHub)
├── publish.sh                # Build, test, publish workflow
├── README.md
└── LICENSE

许可证

麻省理工学院

相关 MCP