Google News

Google News

🚀 Google新闻服务器

这是一个基于Node.js和MCP协议实现的Google新闻服务器。本项目提供了完整的安装、配置和使用指南,帮助你快速搭建并使用该服务器。

🚀 快速开始

安装依赖

在终端中运行以下命令:

npm install

配置环境变量

编辑你的 claude_desktop_config.json 文件,添加以下内容(请根据实际路径进行调整):

    "google-news": {
"command": "D:\\Program\\nvm\\node.exe",
"args": [
"D:\\github_repository\\your-repository-path\\dist\\index.js"
],
"env": {
"SERP_API_KEY": "你的API密钥"
}
}

构建项目

运行以下命令进行构建:

npm run build

启动服务

运行以下命令启动服务器:

npm start

✨ 主要特性

  • 基于Node.js和MCP协议实现,提供稳定的Google新闻服务。
  • 多种安装方式,方便不同用户的需求。
  • 详细的API文档,便于开发者进行二次开发。

📦 安装指南

使用Smithery自动安装

通过Smithery一键安装:

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

手动安装

使用npm

npm i @chanmeng666/google-news-server

使用yarn

yarn add @chanmeng666/google-news-server

使用pnpm

pnpm add @chanmeng666/google-news-server

💻 使用示例

基础用法

在配置好环境并启动服务后,你可以通过API进行新闻搜索等操作。以下是一个简单的调用示例:

# 假设使用curl调用API,这里仅为示意
curl "your-api-url?q=news&gl=us&hl=en"

高级用法

你可以根据具体需求组合不同的参数,实现更精准的新闻搜索:

# 搜索特定主题的新闻
curl "your-api-url?q=tech-news&topic_token=tech&gl=us&hl=en"

📚 详细文档

故障排除

  1. API密钥无效

    • 检查 claude_desktop_config.json 文件中的API密钥配置是否正确。
    • 确认在SERP API控制台中API密钥处于启用状态。
  2. 请求失败

    • 检查网络连接状态。
    • 确保API调用配额未超过限制。
    • 验证请求参数格式是否正确。

开发指南

运行开发模式

npm run dev

测试

运行以下命令进行测试:

npm test

🔧 技术细节

技术栈

  • TypeScript:提供类型检查,增强代码的可维护性。
  • Node.js:作为服务器运行环境,提供高效的事件驱动I/O。
  • MCP协议:用于实现服务器与客户端之间的通信。

📄 API文档

接口参数

参数 详情
q 搜索查询字符串
gl 国家代码(例如:'us', 'uk')
hl 语言代码(例如:'en', 'es')
topic_token 特定新闻主题令牌
publication_token 特定发布者令牌
story_token 特定故事覆盖令牌
section_token 特定部分令牌

返回值

根据具体接口和使用场景,返回相应的数据格式。

📄 许可证

暂未提及相关许可证信息。

📞 支持与帮助

如有任何问题,请联系项目维护人员或参考官方文档。

  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-23 08:36

相似服务问题