关于 GNews
GNews 是连接兼容客户端与 GNews API 的托管 MCP 服务。它提供关键词文章搜索,以及按类别和国家获取头条的功能,需要 API 密钥。
主要功能
- 01按关键词搜索文章
- 02获取热门头条
- 03按类别和国家筛选头条
- 04通过托管 HTTP 端点连接
适用场景
- 01查找某个主题的最新文章
- 02获取指定国家的科技头条
MCP 相关
该服务通过 HTTP 向 MCP 客户端提供 GNews API 的搜索和头条工具。请求需在 `X-Api-Key` 标头中提供 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://mcp.gnews.io/一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http gnews-io-gnews https://mcp.gnews.io/Cursor.cursor/mcp.json
{"mcpServers":{"gnews-io-gnews":{"type":"http","url":"https://mcp.gnews.io/"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"gnews-io-gnews":{"type":"http","url":"https://mcp.gnews.io/"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"gnews-io-gnews":{"type":"http","url":"https://mcp.gnews.io/"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"gnews-io-gnews":{"serverUrl":"https://mcp.gnews.io/"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://mcp.gnews.io/需要授权工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 是 | |
| max | integer | 否 | |
| lang | any | 否 | |
| page | integer | 否 | |
| sortby | enum | 否 | publishedAt | relevance |
| country | any | 否 | |
| date_to | any | 否 | |
| date_from | any | 否 | |
| in_fields | any | 否 |
详细介绍
📡 GNews API MCP 服务
本文档介绍一个用于开放 GNews API 的 Model Context Protocol(MCP) 服务。
该服务已部署并公开访问,因此你无需安装任何内容。 只需将它连接到兼容的 MCP 客户端(Claude Code、Gemini CLI 等)即可。
🔑 GNews API 密钥
要使用此服务,你需要有效的 GNews 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
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。