Google News MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides Google News search capabilities via SerpAPI integration, supporting flexible search options, global coverage, smart categorization of news results, and multiple result types.

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona funciones de búsqueda en Google Noticias mediante la integración con SerpAPI. Categoriza automáticamente los resultados de noticias y es compatible con varios idiomas y regiones.

https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

✨ Características

🔍 Opciones de búsqueda flexibles

Capacidades de búsqueda integrales que incluyen búsqueda basada en consultas, búsqueda de temas, filtrado de publicaciones y cobertura de historias.

🌐 Cobertura global

Admite múltiples idiomas y regiones a través de códigos de idioma y país configurables.

📊 Categorización inteligente

Categoriza automáticamente los resultados de noticias en temas como IA y tecnología, negocios, ciencia e investigación y atención médica.

🔀 Múltiples tipos de resultados

Maneja varios tipos de resultados de noticias, incluidos titulares, historias, temas relacionados y enlaces de menú.

🛠️ Manejo robusto de errores

Manejo integral de errores para fallas de API y entradas no válidas, con mensajes de error útiles.

🌍 Soporte de idiomas

Retorno automático al inglés para códigos de idioma no admitidos con notificaciones de usuario apropiadas.

Guía de configuración de la API SERP

Antes de empezar, necesitarás obtener una clave API de SERP. Aquí te explicamos cómo:

  1. Visita el sitio web de SERP API y crea una cuenta
  2. Después de registrarse, vaya a su Panel de Control:
    • Localice la sección "Clave API"
    • Copia tu clave API
    • Los nuevos usuarios obtienen 100 llamadas API gratuitas
  3. Detalles de uso de la API:
    • Nivel gratuito: 100 búsquedas por mes
    • Los planes pagos comienzan en $50/mes por 5000 búsquedas
    • Facturación basada en llamadas API exitosas
    • Múltiples métodos de pago: Tarjeta de crédito, PayPal, etc.
  4. Límites de uso:
    • Tasa de solicitud: 2 solicitudes/segundo
    • Restricciones de IP: Ninguna
    • Solicitudes concurrentes: 5
    • Tiempo de caché de respuesta: 1 hora

👩‍🔧 Solución para problemas de conexión de servidores MCP con NVM/NPM

Haga clic para ver mi solución de configuración 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Inicio rápido

  1. Instalar dependencias:
npm install
  1. Configurar el entorno: Modifique su claude_desktop_config.json con el siguiente contenido (ajuste las rutas según su sistema):
"google-news": { "command": "D:\\Program\\nvm\\node.exe", "args": [ "D:\\github_repository\\path_to\\dist\\index.js" ], "env": { "SERP_API_KEY": "your-api-key" } }
  1. Construir el servidor:
npm run build
  1. Iniciar el servidor:
npm start

Solución de problemas

  1. Clave API no válida
  • Verificar la configuración de la clave API en claude_desktop_config.json
  • Confirmar que la clave API esté activa en el panel de API de SERP
  1. Fallas de solicitud
  • Comprobar la conectividad de la red
  • Verificar que no se haya excedido la cuota de llamadas API
  • Validar el formato de los parámetros de solicitud

📦 Instalación

Instalación mediante herrería

Para instalar Google News para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

Instalación mediante mcp-get

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

Si está utilizando una versión antigua de Windows PowerShell, es posible que deba ejecutar Set-ExecutionPolicy Bypass -Scope Process antes de este comando.

Instalación manual

@chanmeng666/servidor de noticias de Google

# 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

Pila tecnológica

📖 Documentación de la API

El servidor implementa el Protocolo de Contexto de Modelo y expone una herramienta de búsqueda de Google News con los siguientes parámetros:

  • q : Cadena de consulta de búsqueda
  • gl : Código de país (por ejemplo, 'nosotros', 'reino unido')
  • hl : Código de idioma (p. ej., 'en', 'es')
  • topic_token : Token para temas de noticias específicos
  • publication_token : Token para editores específicos
  • story_token : Token para la cobertura completa de una historia
  • section_token : Token para secciones específicas

🔧 Desarrollo

# Run in development mode with hot reload npm run dev # Run linting npm run lint # Run tests npm run test

📝 Licencia

Este proyecto tiene licencia MIT .

🙋‍♀ Autor

Creado y mantenido por Chan Meng .

ID: dbx6imq4ef