<div align="center"> <h1><img src="public/server-google-news.svg" width="80px"><br/>Google News MCP 服务器</h1> <img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white"/> <img src="https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white"/> <img src="https://img.shields.io/badge/MCP-Server-blue?style=flat"/> <img src="https://img.shields.io/badge/License-MIT-brightgreen?style=flat"/> </div> <br/>

<br/>

一个模型上下文协议 (MCP) 服务器实现，通过 SerpAPI 集成提供 Google 新闻搜索功能。自动对新闻结果进行分类，并支持多种语言和地区。

<a href="https://glama.ai/mcp/servers/dbx6imq4ef"><img width="380" height="200" src="https://glama.ai/mcp/servers/dbx6imq4ef/badge" alt="Google News Server MCP server" /></a>

<br/>

<br/>

https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

✨ 特性

🔍 灵活的搜索选项

全面的搜索功能，包括基于查询的搜索、主题搜索、出版物过滤和新闻报道。

🌐 全球覆盖

通过可配置的语言和国家/地区代码支持多种语言和地区。

📊 智能分类

自动将新闻结果分类到诸如 AI 和技术、商业、科学与研究以及医疗保健等主题中。

🔀 多种结果类型

处理各种新闻结果类型，包括头条新闻、新闻报道、相关主题和菜单链接。

🛠️ 强大的错误处理

针对 API 故障和无效输入的全面错误处理，并提供有用的错误消息。

🌍 语言支持

对于不支持的语言代码，自动回退到英语，并提供适当的用户通知。

🔑 SERP API 设置指南

在开始之前，您需要获取一个 SERP API 密钥。方法如下：

1. 访问 SERP API 网站 并创建一个帐户

2. 注册后，转到您的仪表板：

   • 找到“API 密钥”部分
   • 复制您的 API 密钥
   • 新用户可获得 100 次免费 API 调用

3. API 使用详情：

   • 免费套餐：每月 100 次搜索
   • 付费计划起价为每月 50 美元，可进行 5000 次搜索
   • 根据成功的 API 调用进行计费
   • 多种付款方式：信用卡、PayPal 等。

4. 使用限制：

   • 请求速率：2 个请求/秒
   • IP 限制：无
   • 并发请求：5
   • 响应缓存时间：1 小时

👩‍🔧 解决 MCP 服务器与 NVM/NPM 的连接问题

点击查看我的配置解决方案 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 快速开始

1. 安装依赖项：

npm install

2. 配置环境： 使用以下内容修改您的 claude_desktop_config.json（根据您的系统调整路径）：

    "google-news": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\github_repository\\path_to\\dist\\index.js"
      ],
      "env": {
        "SERP_API_KEY": "your-api-key"
      }
    }

3. 构建服务器：

npm run build

4. 启动服务器：

npm start

故障排除

1. 无效的 API 密钥

• 验证 claude_desktop_config.json 中的 API 密钥配置
• 确认 API 密钥在 SERP API 仪表板中处于活动状态

2. 请求失败

• 检查网络连接
• 验证是否已超过 API 调用配额
• 验证请求参数格式

📦 安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Google News：

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

通过 mcp-get 安装

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

如果您使用的是旧版本的 Windows PowerShell，您可能需要在运行此命令之前运行 Set-ExecutionPolicy Bypass -Scope Process。

手动安装

<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-news-server">@chanmeng666/google-news-server</a>

# 使用 npm
npm i @chanmeng666/google-news-server
# 或
npm install @chanmeng666/google-news-server

# 使用 yarn
yarn add @chanmeng666/google-news-server

# 使用 pnpm
pnpm add @chanmeng666/google-news-server

💻 技术栈

📖 API 文档

该服务器实现了模型上下文协议，并公开了一个 Google 新闻搜索工具，具有以下参数：

• q: 搜索查询字符串
• gl: 国家/地区代码（例如，“us”、“uk”）
• hl: 语言代码（例如，“en”、“es”）
• topic_token: 特定新闻主题的令牌
• publication_token: 特定出版商的令牌
• story_token: 新闻报道完整覆盖的令牌
• section_token: 特定版块的令牌

🔧 开发

# 在开发模式下运行，带有热重载
npm run dev

# 运行 linting
npm run lint

# 运行测试
npm run test

📝 许可证

此项目已获得 MIT 许可。

🙋‍♀ 作者

由 Chan Meng 创建和维护。