GNews

io.github.gnews-iov1.0.0更新于 Oct 7, 2026

Official GNews API server: search news articles and top headlines from 80,000+ sources.

已验证Streamable HTTP可网页运行Web Search & ScrapingCommunication & Collaboration

概览

AI 生成的概览

让助手在 GNews 覆盖 8 万多个来源的新闻库中搜索文章并获取头条新闻。

功能
这是一个托管型 MCP 服务器，对外提供 GNews API。它包含两个工具：search 通过关键词组合搜索新闻文章，top_headlines 按类别和国家获取头条新闻。结果可按语言和最大数量限制，示例包括搜索英文气候变化文章或获取美国科技类头条。
适用场景
当助手需要最新新闻报道、基于关键词的文章检索，或按类别和国家筛选的头条时使用。适合依赖近期报道的研究、监测和摘要任务，而非通用网页搜索。
运行要求
需要支持 streamable HTTP 的远程 MCP 客户端，例如 Claude Code 或 Gemini CLI。必须提供有效的 GNews API 密钥，并通过 X-Api-Key HTTP 请求头发送；可向服务商申请免费密钥。无需本地安装或软件包，建议使用 HTTPS 连接。
安装前请注意
X-Api-Key 请求头携带的是机密 API 密钥，应像密码一样对待，切勿分享。该服务器仅作代理，不存储密钥，但每次请求都会把密钥转发给 GNews API。托管服务器会记录每次工具调用的匿名使用统计，包括工具名称、客户端名称和版本、成功或失败、耗时，以及 lang、country、category、max、page 和 sortby 等参数；密钥仅以单向哈希形式记录，搜索查询不会被记录。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GNews，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "gnews": {
      "type": "http",
      "url": "https://mcp.gnews.io/"
    }
  }
}

README

📡 GNews API MCP Server

This document describes a Model Context Protocol (MCP) server that exposes the GNews API.

This server is already deployed and publicly accessible, so you don't need to install anything. You just need to connect it to your compatible MCP client (Claude Code, Gemini CLI, etc.).

🔑 GNews API Key

To use this server, you need a valid GNews API key.

👉 Get your API key here

The API key must be provided in the following way:

  • Via an HTTP header X-Api-Key

🔗 MCP Integration

This server is listed in the official MCP Registry as io.github.gnews-io/gnews.

With Claude Code

Add the server to your Claude Code configuration with the following command:

bash
claude mcp add --transport http gnews_api https://mcp.gnews.io/ --header "X-Api-Key: YOUR_API_KEY"

🛠️ Available Tools

Once the server is connected, the following two tools are available:

  • search: Search for news articles through a combination of keywords.
  • top_headlines: Get top headlines by category and country.

📄 Usage Examples

Search for articles

This example searches for the 5 latest English articles on climate change:

json
{  "tool": "search",  "args": {    "q": "climate change",    "lang": "en",    "max": 5  }}

Get latest headlines

This example retrieves the 5 top headlines from the "technology" category in the United States:

json
{  "tool": "top_headlines",  "args": {    "category": "technology",    "country": "us",    "max": 5  }}

🔒 Security

  • Never share your API key. Treat it like a password.
  • This server acts as a proxy: it does not store any API keys. Your key is transmitted directly to GNews API with each request.
  • Always use an HTTPS connection to communicate with the server to ensure your key is encrypted in transit.
  • The hosted server records anonymous usage statistics for each tool call: tool name, MCP client name and version, success or error, duration, and the lang, country, category, max, page and sortby parameters. Your API key is only recorded as a one-way hash, and your search queries are never recorded.

📋 Client Prerequisites

  • A compatible MCP client (e.g., Claude Code).
  • The latest version of Gemini CLI is recommended for optimal compatibility.

来源：README.md，提交 8b06451

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 7, 2026