mcpField
G
GNews

GNews

远程服务
gnews.io搜索与检索23 周前更新

关于 GNews

GNews 是连接兼容客户端与 GNews API 的托管 MCP 服务。它提供关键词文章搜索,以及按类别和国家获取头条的功能,需要 API 密钥。

主要功能

  1. 01按关键词搜索文章
  2. 02获取热门头条
  3. 03按类别和国家筛选头条
  4. 04通过托管 HTTP 端点连接

适用场景

  1. 01查找某个主题的最新文章
  2. 02获取指定国家的科技头条

MCP 相关

该服务通过 HTTP 向 MCP 客户端提供 GNews API 的搜索和头条工具。请求需在 `X-Api-Key` 标头中提供 API 密钥。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.gnews.io/
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://mcp.gnews.io/需要授权

工具

2
参数类型必填说明
qstring是
maxinteger否
langany否
pageinteger否
sortbyenum否publishedAt | relevance
countryany否
date_toany否
date_fromany否
in_fieldsany否

详细介绍

📡 GNews API MCP 服务

本文档介绍一个用于开放 GNews API 的 Model Context Protocol(MCP) 服务。

该服务已部署并公开访问,因此你无需安装任何内容。 只需将它连接到兼容的 MCP 客户端(Claude Code、Gemini CLI 等)即可。


🔑 GNews API 密钥

要使用此服务,你需要有效的 GNews API 密钥。

👉 在此获取 API 密钥

必须通过以下方式提供 API 密钥:

  • 通过 HTTP 标头 X-Api-Key

🔗 MCP 集成

此服务已列入官方 MCP Registry,名称为 io.github.gnews-io/gnews。

使用 Claude Code

使用以下命令将服务添加到 Claude Code 配置中:

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

🛠️ 可用工具

连接服务后,可使用以下两种工具:

  • search:通过组合关键词搜索新闻文章。
  • top_headlines:按类别和国家/地区获取头条新闻。

📄 使用示例

搜索文章

此示例用于搜索有关气候变化的最新 5 篇英文文章:

{
  "tool": "search",
  "args": {
    "q": "climate change",
    "lang": "en",
    "max": 5
  }
}
获取最新头条新闻

此示例用于获取美国“technology”类别的5 条头条新闻:

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

🔒 安全

  • 切勿分享你的 API 密钥。请像对待密码一样保护它。
  • 此服务充当代理:不会存储任何 API 密钥。 每次请求时,你的密钥都会直接发送到 GNews API。
  • 始终通过 HTTPS 连接与服务通信,确保密钥在传输过程中加密。
  • 托管服务会记录每次工具调用的匿名使用统计信息:工具名称、MCP 客户端名称和版本、成功或错误状态、耗时,以及 lang、country、category、max、page 和 sortby 参数。 你的 API 密钥只会以单向哈希的形式记录,搜索查询则绝不会被记录。

📋 客户端前置条件

  • 兼容的 MCP 客户端(例如 Claude Code)。
  • 建议使用最新版本的 Gemini CLI,以获得最佳兼容性。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。