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

2. Construir el servidor:

npm run build

3. 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"
      }
    }

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

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

Related MCP server: Google News13 MCP Server

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

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

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