Google News MCP Server

[![Star This Project](https://img.shields.io/github/stars/ChanMeng666/server-google-news.svg?style=social)](https://github.com/ChanMeng666/server-google-news/stargazers)
A Model Context Protocol (MCP) server implementation that provides Google News search capabilities via SerpAPI integration. Automatically categorizes news results and supports multiple languages and regions.

[![👉Try It Now!👈](https://gradient-svg-generator.vercel.app/api/svg?text=%F0%9F%91%89Try%20It%20Now!%F0%9F%91%88&color=000000&height=60&gradientType=radial&duration=6s&color0=ffffff&template=pride-rainbow)](https://smithery.ai/server/@chanmeng666/google-news-server)
https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779 ![屏幕截图 2024-12-30 021446](https://github.com/user-attachments/assets/34985fac-a529-4aac-a77d-b0b93f70d0f7) ![屏幕截图 2024-12-30 021524](https://github.com/user-attachments/assets/6d1d3069-db04-421e-83b9-6ecdbce4847e) ![屏幕截图 2024-12-30 021914](https://github.com/user-attachments/assets/16889a09-c05d-47dc-b3fe-5ea3771e059d) ![屏幕截图 2024-12-30 021941](https://github.com/user-attachments/assets/da20e7a6-f2e8-4aec-bab9-f19322d0f798) # ✨ Features ### 🔍 Flexible Search Options Comprehensive search capabilities including query-based search, topic search, publication filtering and story coverage. ### 🌐 Global Coverage Supports multiple languages and regions through configurable language and country codes. ### 📊 Smart Categorization Automatically categorizes news results into topics like AI & Technology, Business, Science & Research, and Healthcare. ### 🔀 Multiple Result Types Handles various news result types including headlines, stories, related topics and menu links. ### 🛠️ Robust Error Handling Comprehensive error handling for API failures and invalid inputs, with helpful error messages. ### 🌍 Language Support Automatic fallback to English for unsupported language codes with appropriate user notifications. # 🔑 SERP API Setup Guide Before getting started, you'll need to obtain a SERP API key. Here's how: 1. Visit [SERP API website](https://serpapi.com/) and create an account 2. After registration, go to your Dashboard: - Locate the "API Key" section - Copy your API key - New users get 100 free API calls 3. API Usage Details: - Free tier: 100 searches per month - Paid plans start at $50/month for 5000 searches - Billing based on successful API calls - Multiple payment methods: Credit Card, PayPal, etc. 4. Usage Limits: - Request Rate: 2 requests/second - IP Restrictions: None - Concurrent Requests: 5 - Response Cache Time: 1 hour # 👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM Click to view my configuration solution 👉 https://github.com/modelcontextprotocol/servers/issues/76 # 🚀 Quick Start 1. Install dependencies: ```bash npm install ``` 2. Configure environment: Modify your `claude_desktop_config.json` with the following content (adjust paths according to your system): ```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" } } ``` 3. Build the server: ```bash npm run build ``` 4. Start the server: ```bash npm start ``` ## Troubleshooting 1. Invalid API Key - Verify API key configuration in `claude_desktop_config.json` - Confirm API key is active in SERP API dashboard 2. Request Failures - Check network connectivity - Verify API call quota hasn't been exceeded - Validate request parameter format # 📦 Installation ## Installing via Smithery To install Google News for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@chanmeng666/google-news-server): ```bash npx -y @smithery/cli install @chanmeng666/google-news-server --client claude ``` [![smithery badge](https://smithery.ai/badge/@chanmeng666/google-news-server)](https://smithery.ai/server/@chanmeng666/google-news-server) ## Installing via mcp-get ```bash npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server ``` > If you are using an old version of Windows PowerShell, you may need to run `Set-ExecutionPolicy Bypass -Scope Process` before this command. ## Manual Installation

@chanmeng666/google-news-server ```bash # 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 ``` # 💻 Tech Stack ![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white) ![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge&logo=node.js&logoColor=white) ![MCP](https://img.shields.io/badge/MCP-SDK-blue?style=for-the-badge) # 📖 API Documentation The server implements the Model Context Protocol and exposes a Google News search tool with the following parameters: - `q`: Search query string - `gl`: Country code (e.g., 'us', 'uk') - `hl`: Language code (e.g., 'en', 'es') - `topic_token`: Token for specific news topics - `publication_token`: Token for specific publishers - `story_token`: Token for full coverage of a story - `section_token`: Token for specific sections # 🔧 Development ```bash # Run in development mode with hot reload npm run dev # Run linting npm run lint # Run tests npm run test ``` # 📝 License This project is [MIT licensed](./LICENSE). # 🙋‍♀ Author Created and maintained by [Chan Meng](https://chanmeng.live/). [![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=normal&logo=github&logoColor=white)](https://github.com/ChanMeng666) [![LinkedIn](https://img.shields.io/badge/linkedin-%230077B5.svg?style=normal&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/chanmeng666/)