Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chanmeng666/server-google-news
【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.
https://github.com/chanmeng666/server-google-news
ai claude claude-desktop google-news-api mcp mcp-server modelcontextprotocol news-aggregation news-search nodejs serpapi typescript
Last synced: 10 days ago
JSON representation
【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.
- Host: GitHub
- URL: https://github.com/chanmeng666/server-google-news
- Owner: ChanMeng666
- License: mit
- Created: 2024-12-29T12:48:15.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2025-01-15T04:16:03.000Z (11 days ago)
- Last Synced: 2025-01-15T06:13:50.427Z (11 days ago)
- Topics: ai, claude, claude-desktop, google-news-api, mcp, mcp-server, modelcontextprotocol, news-aggregation, news-search, nodejs, serpapi, typescript
- Language: JavaScript
- Homepage: https://glama.ai/mcp/servers/dbx6imq4ef
- Size: 104 KB
- Stars: 5
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Google News MCP Server
[](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.
[](https://smithery.ai/server/@chanmeng666/google-news-server)
https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779
# ✨ 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
```
[](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
# 📖 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/).
[](https://github.com/ChanMeng666)
[](https://www.linkedin.com/in/chanmeng666/)