JinDaGe - Google News MCP Details

article

README

🚀 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"

📚 详细文档

故障排除

API密钥无效
- 检查 claude_desktop_config.json 文件中的API密钥配置是否正确。
- 确认在SERP API控制台中API密钥处于启用状态。
请求失败
- 检查网络连接状态。
- 确保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 | 特定部分令牌 |

返回值

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

📄 许可证

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

📞 支持与帮助

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

Google News