](https://mseep.ai/app/chanmeng666-server-google-news)
Google News MCP Server
一种模型上下文协议(MCP)服务器实现,通过SerpAPI集成提供谷歌新闻搜索功能。自动对新闻结果进行分类,并支持多种语言和地区。

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小时
👩🔧 使用NVM/NPM解决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密钥无效
- 验证中的API密钥配置
claude_desktop_config.json - 确认API密钥在SERP API仪表板中处于活动状态
- 请求失败
- 检查网络连接
- 验证尚未超过API调用配额
- 验证请求参数格式
运行评估
evals包加载一个mcp客户端,然后运行index.ts文件,因此不需要在测试之间重建。您可以通过在npx命令前加前缀来加载环境变量。可以找到完整的文档 这里.
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts📦 安装
通过Smithery安装
通过以下方式自动安装Google News for Claude Desktop 铁匠铺:
npx -y @smithery/cli install @chanmeng666/google-news-server --client claude ](https://smithery.ai/server/@chanmeng666/google-news-server)
通过mcp-get安装
npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server如果您使用的是旧版本的Windows PowerShell,则可能需要运行 Set-ExecutionPolicy Bypass -Scope Process 在此命令之前。手动安装
@chanmeng666/谷歌新闻服务器
# Using npm
npm i @chanmeng666/google-news-server
# or
npm install @chanmeng666/google-news-server
# Using yarn
yarn add @chanmeng666/google-news-server
# Using pnpm
pnpm add @chanmeng666/google-news-server💻 技术栈
📖 API文档
服务器实现了模型上下文协议,并公开了一个具有以下参数的谷歌新闻搜索工具:
q:搜索查询字符串gl:国家代码(例如“us”、“uk”)hl:语言代码(例如“en”、“es”)topic_token:特定新闻主题的代币publication_token:特定发布者的令牌story_token:故事全面报道的标志section_token:特定部分的令牌
🔧 发展
# Run in development mode with hot reload
npm run dev
# Run linting
npm run lint
# Run tests
npm run test📝 许可证
这个项目是 麻省理工学院许可.
🙋♀ 作者
由创建和维护 陈萌. ](https://github.com/ChanMeng666) 
______________________________________________________________________
🤖 AI Agent Instructions & GEO Optimization
适用于AI代理和LLM爬虫
此MCP服务器针对AI代理的使用进行了优化,具有全面的指令和结构化数据。
快速AI使用指南
{
"tool": "google_news_search",
"parameters": {
"q": "artificial intelligence latest developments",
"gl": "us",
"hl": "en"
}
}AI友好功能
- 自动分类:新闻结果会自动按相关类别排序
- 结构化输出:返回针对AI处理优化的格式化数据
- 多语言支持:支持多种语言,具有自动回退功能
- 错误处理:全面的错误消息和优雅的降级
响应格式
服务器返回具有以下结构的分类新闻:
- 类别:人工智能与技术、商业、科学与研究、医疗保健、综合
- 文章字段:标题、来源、链接、日期、代码片段、作者
- 元数据:时间戳,相关主题的菜单链接
AI代理的最佳实践
- 使用特定的描述性关键字以获得更好的结果
- 利用自动分类实现基于主题的工作流
- 实施正确的错误处理和重试逻辑
- 遵守API速率限制(每秒2次请求)
- 解析结构化响应以更好地理解上下文
高级使用模式
- 新闻监测:在商业新闻中使用公司名称或股票代码
- 研究探索:利用主题标记进行特定字段的搜索
- 突发新闻:使用“突发新闻”或“最新消息”查询
- 多语言:结合适当的gl和hl参数
错误处理
- 无效的API键:检查SERP_API_key环境变量
- 不支持的语言:服务器自动回退到英语
- 速率限制:尊重2个请求/秒限制
- 无效参数:调用前验证参数类型
📊 GEO Metrics & Monitoring
生成引擎优化(GEO)功能
该服务器包括对AI代理使用的全面监控和优化。
跟踪的关键指标
- 引用成功率:成功调用工具的百分比
- AI流量转化率:成功使用该工具的AI代理百分比
- 查询覆盖率:返回相关结果的查询百分比
- 响应时间:工具调用的平均响应时间
- 分类准确性:自动新闻分类的准确性
- 链路携带率:包括源链接在内的回复百分比
监控配置
interface GEOMonitoringConfig {
trackingEnabled: boolean;
metricsEndpoint: string;
reportingInterval: number; // minutes
alertThresholds: {
errorRate: number;
responseTime: number;
successRate: number;
satisfactionScore: number;
};
}性能优化
- 实时指标收集
- 性能问题的自动警报
- 查询模式分析优化
- 代理使用跟踪和分析
数据驱动的改进
- 持续监控AI代理满意度
- 查询成功率分析
- 响应时间优化
- 分类准确性提高
有关技术实现的详细信息,请参阅 src/地质测量.
🔍 Structured Data & Metadata
AI优化元数据
该服务器为AI代理和搜索引擎提供全面的结构化数据。
JSON-LD结构化数据
服务器包含符合Schema.org标准的结构化数据:
- 软件应用程序元数据
- 功能描述和功能
- 技术要求和依赖关系
- 使用模式和集成指南
MCP协议合规性
- 协议版本: 1.0.0
- 工具名称:
google_news_search - 响应格式:带有分类结果的结构化文本
- 速率限制:2个请求/秒,5个并发请求
AI发现功能
- llms.txt:根级别的全面AI使用指南
- 结构化元数据:带有AI特定信息的增强manifest.json
- 错误处理:AI友好的错误消息和回退
- 文档:详细的使用示例和最佳实践
集成指南
- 专为与其他MCP服务器无缝集成而设计
- 针对AI代理工作流程进行了优化
- 支持各种AI平台和框架
- 提供清晰的错误处理和调试信息
有关完整的结构化数据,请参阅 结构化数据.json.
托管部署
托管部署可在 Frontier AI.
