谷歌新闻服务器
项目介绍
技术文档摘要
一个通过与 SerpAPI 集成来提供 Google 新闻搜索功能的 Model Context Protocol (MCP) 服务器实现。自动对新闻结果进行分类，并支持多种语言和地区。
<a href="https://glama.ai/mcp/servers/dbx6imq4ef"><img width="380" height="200" src="https://gips0.baidu.com/it/u=2298943891,1877396826&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Google News Server MCP 服务器" /></a>
<br/>https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779
✨ 特性
🔍 灵活的搜索选项
包括基于查询的搜索、主题搜索、出版物过滤和故事覆盖在内的全面搜索能力。
🌐 全球覆盖
通过可配置的语言和地区代码支持多种语言和地区。
📊 智能分类
自动将新闻结果分类到如人工智能和技术、商业、科学与研究以及医疗保健等主题中。
🔀 多种结果类型
处理各种新闻结果类型，包括标题、故事、相关主题和菜单链接。
🛠️ 坚固的错误处理
对于 API 失败和无效输入有全面的错误处理机制，带有有用的错误消息。
🌍 语言支持
对于不支持的语言代码，自动回退到英语，并适当通知用户。
🔑 SerpApi 设置指南
在开始之前，您需要获取一个 SerpApi 密钥。以下是步骤：
-
访问 SerpApi 网站 并创建一个账户
-
注册后，进入您的仪表板：
- 找到“API 密钥”部分
- 复制您的 API 密钥
- 新用户可以免费获得 250 次 API 调用
-
API 使用详情：
- 免费层级：每月 250 次搜索
- 付费计划从每月 75 美元起，包含 5000 次搜索
- 根据成功的 API 调用来计费
- 支持多种支付方式：信用卡、PayPal 等
-
使用限制：
- 请求速率：每秒 2 次请求
- IP 限制：无
- 并发请求：5 次
- 响应缓存时间：1 小时
👩🔧 解决 MCP 服务器连接问题的方法
点击查看我的配置解决方案 👉 https://github.com/modelcontextprotocol/servers/issues/76
🚀 快速开始
- 安装依赖项：
npm install
- 构建服务器：
npm run build
- 配置环境：
修改您的
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"
}
}
- 启动服务器：
npm start
故障排除
- 无效的 API 密钥
- 在
claude_desktop_config.json中验证 API 密钥配置 - 确认 API 密钥在 SERP API 仪表板中是有效的
- 请求失败
- 检查网络连接
- 确认 API 调用配额未被超过
- 验证请求参数格式
运行评估
评估包加载了一个 mcp 客户端，然后运行 index.ts 文件，因此在测试之间无需重新构建。您可以通过前缀 npx 命令来加载环境变量。完整的文档可以在 这里 找到。
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts
📦 安装
通过 Smithery 安装
要通过 Smithery 自动安装 Google News for Claude Desktop：
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 文档
该服务器实现了 Model Context Protocol，并公开了具有以下参数的 Google 新闻搜索工具：
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 创建和维护。
<details> <summary>🤖 AI 代理指令及 GEO 优化</summary>
对于 AI 代理和 LLM 爬虫
此 MCP 服务器针对 AI 代理使用进行了优化，提供了全面的指令和结构化数据。
快速 AI 使用指南
{
"tool": "google_news_search",
"parameters": {
"q": "人工智能最新发展",
"gl": "us",
"hl": "en"
}
}
AI 友好特性
- 自动分类：新闻结果会自动排序到相关的类别中
- 结构化输出：返回优化用于 AI 处理的格式化数据
- 多语言支持：支持多种语言，并有自动回退机制
- 错误处理：全面的错误消息和优雅降级
响应格式
服务器返回分类新闻，其结构如下：
- 类别：人工智能和技术、商业、科学与研究、医疗保健、综合
- 文章字段：标题、来源、链接、日期、摘要、作者
- 元数据：时间戳、相关主题的菜单链接
AI 代理的最佳实践
- 使用具体描述性的关键词以获得更好的结果
- 利用自动分类进行主题工作流
- 实现适当的错误处理和重试逻辑
- 尊重 API 速率限制（每秒 2 次请求）
- 解析结构化的响应以更好地理解上下文
高级使用模式
- 新闻监控：使用公司名称或股票代码获取商业新闻
- 研究探索：利用主题令牌进行领域特定搜索
- 突发新闻：使用“突发新闻”或“最新新闻”查询
- 多语言：结合适当的 gl 和 hl 参数
错误处理
- 无效 API 密钥：检查 SERP_API_KEY 环境变量
- 不支持的语言：服务器自动回退到英语
- 速率限制：尊重每秒 2 次请求的限制
- 无效参数：调用前验证参数类型
生成引擎优化 (GEO) 功能
此服务器包括针对 AI 代理使用的全面监控和优化。
关键跟踪指标
- 引用成功率：成功工具调用的百分比
- AI 流量转化率：成功使用工具的 AI 代理的百分比
- 查询覆盖率：返回相关结果的查询百分比
- 响应时间：工具调用的平均响应时间
- 分类准确性：自动新闻分类的准确性
- 链接携带率：包含来源链接的响应百分比
监控配置
interface GEOMonitoringConfig {
trackingEnabled: boolean;
metricsEndpoint: string;
reportingInterval: number; // 分钟
alertThresholds: {
errorRate: number;
responseTime: number;
successRate: number;
satisfactionScore: number;
};
}
性能优化
- 实时指标收集
- 自动性能问题警报
- 查询模式分析以优化
- 代理使用跟踪和分析
数据驱动改进
- 持续监控 AI 代理满意度
- 查询成功率分析
- 响应时间优化
- 分类准确性改进
有关技术实施细节，请参阅 src/geo-metrics.ts。
</details> <details> <summary>🔍 结构化数据与元数据</summary>AI 优化元数据
此服务器为 AI 代理和搜索引擎提供了全面的结构化数据。
JSON-LD 结构化数据
服务器包括遵循 Schema.org 标准的结构化数据：
- 软件应用程序元数据
- 功能描述和能力
- 技术要求和依赖关系
- 使用模式和集成指南
MCP 协议合规性
- 协议版本：1.0.0
- 工具名称：
google_news_search - 响应格式：带分类结果的结构化文本
- 速率限制：每秒 2 次请求，最多 5 个并发请求
AI 发现功能
- llms.txt：根目录下的全面 AI 使用指南
- 结构化元数据：增强的 manifest.json，包含 AI 特定信息
- 错误处理：AI 友好的错误消息和回退
- 文档：详细的使用示例和最佳实践
集成指南
- 设计为与其他 MCP 服务器无缝集成
- 优化用于 AI 代理工作流
- 支持多种 AI 平台和框架
- 提供清晰的错误处理和调试信息
有关完整的结构化数据，请参阅 structured-data.json。
</details>