Google News MCP Server

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:

2. Construir el servidor:

3. Configurar el entorno: Modifique su claude_desktop_config.json con el siguiente contenido (ajuste las rutas según su sistema):

4. Iniciar el servidor:

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

2. 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

Ejecución de evaluaciones

El paquete evals carga un cliente mcp que ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puede cargar variables de entorno prefijando el comando npx. Puede encontrar la documentación completa aquí .

📦 Instalación

Instalación mediante herrería

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

Instalación mediante mcp-get

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

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

📝 Licencia

Este proyecto tiene licencia MIT .

🙋‍♀ Autor

Creado y mantenido por Chan Meng .