Google Search Engine

Servidor MCP de Google Search Engine

Un servidor MCP (Model Context Protocol) basado en Cloudflare Workers, que proporciona funcionalidad de búsqueda de Google y extracción de contenido de páginas web con inicio de sesión OAuth integrado.

Desarrollo Local

# Clone the repository
git clone https://github.com/your-username/google-search-engine-mcp-server.git

# Install dependencies
cd google-search-engine-mcp-server
npm install

# Run locally
npm run dev

Visita http://localhost:8787/ para comprobar el estado del servidor

Conectar a la herramienta de prueba MCP Inspector

Usa el MCP Inspector para explorar y probar la API:

• Ejecuta npm run inspector o npx @modelcontextprotocol/inspector
• En la interfaz del Inspector, establece el tipo de transporte a SSE, la URL a http://localhost:8787/sse, y haz clic en "Conectar"
• Ingresa cualquier correo electrónico y contraseña en la interfaz de inicio de sesión simulada
• Después de iniciar sesión, puedes ver y llamar a todas las herramientas disponibles

Herramientas disponibles

Este servidor proporciona las siguientes herramientas:

1. google_search - Realiza búsquedas de Google y devuelve resultados
2. extract_webpage_content - Extrae el contenido de una página web y lo convierte en texto legible
3. batch_extract_webpage_content - Extrae contenido de múltiples páginas web en lote

Conectar a Claude Desktop

Para conectar Claude a tu servidor MCP local:

1. Sigue la Guía de inicio rápido de Anthropic
2. En Claude Desktop, ve a Configuración > Desarrollador > Editar configuración
3. Reemplaza el contenido existente con la siguiente configuración:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Después de iniciar Claude, se abrirá una ventana del navegador que te permitirá iniciar sesión. Puedes ver las herramientas disponibles en la esquina inferior derecha. Con las indicaciones apropiadas, Claude llamará a las herramientas correspondientes.

Desplegar en Cloudflare

1. Crea un espacio de nombres KV: npx wrangler kv namespace create OAUTH_KV
2. Sigue las indicaciones para agregar el ID del espacio de nombres KV a wrangler.jsonc
3. Establece las variables de entorno:
   • GOOGLE_API_KEY - Tu clave de API de Google
   • GOOGLE_SEARCH_ENGINE_ID - Tu ID de motor de búsqueda personalizado de Google
4. Despliega: npm run deploy

Conectar al servidor MCP remoto

Después del despliegue, puedes usar MCP Inspector para conectarte al servidor remoto:

npx @modelcontextprotocol/inspector@latest

Ingresa tu URL de Workers (por ejemplo, your-worker-name.your-account.workers.dev/sse) como dirección del servidor MCP y haz clic en "Conectar".

Conectar Claude Desktop al servidor remoto

Actualiza el archivo de configuración de Claude para que apunte a tu URL de Workers:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account.workers.dev/sse"
      ]
    }
  }
}

Solución de problemas

Si encuentras problemas:

1. Reinicia Claude
2. Intenta conectarte al servidor MCP directamente desde la línea de comandos:

   npx mcp-remote http://localhost:8787/sse
   

3. Limpia los archivos de autenticación de MCP:

   rm -rf ~/.mcp-auth
   

4. Revisa los registros de la consola para obtener información detallada sobre los errores

Notas para desarrolladores

• Este proyecto está desarrollado en TypeScript
• Basado en Cloudflare Workers y Durable Objects
• Integra autenticación OAuth
• Utiliza la API de búsqueda personalizada de Google para la funcionalidad de búsqueda
• Incluye características de extracción y análisis de contenido de páginas web