Google PSE/CSE

Servidor MCP de Google Programmable Search Engine (PSE)

Un servidor del Protocolo de Contexto de Modelos (MCP) para la API de Google Programmable Search Engine (PSE). Este servidor expone herramientas para buscar en la web con el motor de búsqueda personalizado de Google, haciéndolas accesibles a clientes compatibles con MCP como VSCode, Copilot y Claude Desktop.

Pasos de instalación

NO necesita clonar este repositorio manualmente ni ejecutar ningún comando de instalación por su cuenta. Simplemente agregue la configuración a continuación a su cliente MCP correspondiente: su cliente instalará e iniciará automáticamente el servidor cuando sea necesario.

Configuración de VS Code Copilot

Abra la Paleta de Comandos → Preferencias: Abrir Configuración (JSON), luego agregue:

settings.json

{
  // Other settings...
  "mcp": {
    "servers": {
      "google-pse-mcp": {
        "command": "npx",
        "args": [
          "-y",
          "google-pse-mcp",
          "https://www.googleapis.com/customsearch",
          "<api_key>",
          "<cx>",
          "<siteRestricted>" // optional: true/false, defaults to true
        ]
      }
    }
  }
}

Ejemplo de configuración de Cline MCP

Si está usando Cline, agregue lo siguiente a su cline_mcp_settings.json (generalmente ubicado en el almacenamiento global de VSCode o en el directorio de configuración de Cline):

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "google-pse-mcp": {
      "disabled": false,
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "google-pse-mcp",
        "https://www.googleapis.com/customsearch",
        "<api_key>",
        "<cx>",
        "<siteRestricted>" // optional flag, true/false, defaults to true
      ],
      "transportType": "stdio"
    }
  }
}

Notas importantes

No olvide reemplazar <api_key> y <cx> con sus credenciales en la configuración anterior. También puede proporcionar una bandera opcional <siteRestricted> (true o false) como último argumento para controlar qué endpoint de Google Custom Search se utiliza. Si se omite, el valor predeterminado es true.

Herramientas disponibles

Este servidor MCP proporciona la siguiente herramienta:

1. search: Buscar en la web con Google Programmable Search Engine

   • Parámetros:
     • q (cadena, obligatorio): Consulta de búsqueda
     • page (entero, opcional): Número de página
     • size (entero, opcional): Número de resultados de búsqueda a devolver por página (1-10)
     • sort (cadena, opcional): Expresión de ordenación (solo se admite 'date')
     • safe (booleano, opcional): Habilitar el filtrado de búsqueda segura
     • lr (cadena, opcional): Restringir la búsqueda a un idioma particular (p. ej., lang_en)
     • siteRestricted (booleano, opcional): Usar el endpoint de API restringida al sitio; el valor predeterminado es true a menos que se anule mediante la bandera de CLI

Ejemplo de uso

# Search for "artificial intelligence"
result = await use_mcp_tool(
    server_name="google-pse-mcp",
    tool_name="search",
    arguments={
        "q": "artificial intelligence",
        "size": 5,
        "safe": True
    }
)

Enlaces útiles

• Servidores del Protocolo de Contexto de Modelos
• Introducción a Google Programmable Search Engine