Google News MCP 服务器

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

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

✨ 功能

🔍 灵活的搜索选项

全面的搜索功能，包括基于查询的搜索、主题搜索、出版物过滤和故事覆盖。

🌐 全球覆盖

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

📊 智能分类

自动将新闻结果分类为 AI & 技术、商业、科学与研究、医疗保健等主题。

🔀 多种结果类型

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

🛠️ 强大的错误处理

对 API 失败和无效输入进行全面的错误处理，并提供有用的错误信息。

🌍 语言支持

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

🔑 SerpApi 设置指南

在开始之前，您需要获取一个 SerpApi 密钥。以下是步骤：

1. 访问 SerpApi 网站 并创建一个账户

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

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

3. API 使用详情：

   • 免费层：每月 250 次搜索
   • 付费计划从每月 75 美元起，提供 5000 次搜索
   • 基于成功 API 调用的计费
   • 多种支付方式：信用卡、PayPal 等

4. 使用限制：

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

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

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

🚀 快速开始

1. 安装依赖：

npm install

2. 构建服务器：

npm run build

3. 配置环境： 修改您的 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"
      }
    }

4. 启动服务器：

npm start

故障排除

1. 无效的 API 密钥

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

2. 请求失败

• 检查网络连接
• 确认 API 调用配额未超限
• 验证请求参数格式

运行评估

评估包加载一个 mcp 客户端，然后运行 index.ts 文件，因此在测试之间无需重新构建。您可以通过在 npx 命令前添加前缀来加载环境变量。完整文档可以在 这里 找到。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

📦 安装

通过 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。

手动安装

@chanmeng666/google-news-server

# 使用 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 News 搜索工具，具有以下参数：

• q: 搜索查询字符串
• gl: 国家代码（例如 'us', 'uk'）
• hl: 语言代码（例如 'en', 'es'）
• topic_token: 特定新闻主题的令牌
• publication_token: 特定出版商的令牌
• story_token: 故事完整覆盖的令牌
• section_token: 特定部分的令牌

🔧 开发

# 以开发模式运行，支持热重载
npm run dev

# 运行代码检查
npm run lint

# 运行测试
npm run test

📝 许可证

本项目采用 MIT 许可证。

🙋‍♀ 作者

由 Chan Meng 创建和维护。

{
  "tool": "google_news_search",
  "parameters": {
    "q": "artificial intelligence latest developments",
    "gl": "us",
    "hl": "en"
  }
}

监控配置

interface GEOMonitoringConfig {
  trackingEnabled: boolean;
  metricsEndpoint: string;
  reportingInterval: number; // 分钟
  alertThresholds: {
    errorRate: number;
    responseTime: number;
    successRate: number;
    satisfactionScore: number;
  };
}

性能优化

• 实时指标收集
• 自动化的性能问题警报
• 查询模式分析以进行优化
• 代理使用跟踪与分析

数据驱动的改进

• 持续监控AI代理的满意度
• 查询成功率分析
• 响应时间优化
• 分类准确性提升

有关技术实现细节，请参阅 src/geo-metrics.ts。