Google PSE/CSE

Servidor MCP do Google Programmable Search Engine (PSE)

Um servidor Model Context Protocol (MCP) para a API do Google Programmable Search Engine (PSE). Este servidor expõe ferramentas para pesquisar na web com o mecanismo de pesquisa personalizado do Google, tornando-as acessíveis a clientes compatíveis com MCP, como VSCode, Copilot e Claude Desktop.

Etapas de Instalação

Você NÃO precisa clonar este repositório manualmente ou executar comandos de instalação. Basta adicionar a configuração abaixo ao seu respectivo cliente MCP—seu cliente instalará e iniciará o servidor automaticamente conforme necessário.

Configuração do VS Code Copilot

Abra a Paleta de Comandos → Preferências: Abrir Configurações (JSON) e adicione:

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
        ]
      }
    }
  }
}

Exemplo de Configuração MCP do Cline

Se você estiver usando Cline, adicione o seguinte ao seu cline_mcp_settings.json (geralmente encontrado no armazenamento global do VSCode ou no diretório de configuração do 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

Não se esqueça de substituir <api_key> e <cx> pelas suas credenciais na configuração acima. Você também pode fornecer uma flag opcional <siteRestricted> (true ou false) como último argumento para controlar qual endpoint do Google Custom Search é usado. Se omitida, o padrão é true.

Ferramentas Disponíveis

Este servidor MCP fornece a seguinte ferramenta:

1. search: Pesquise na web com o Google Programmable Search Engine

   • Parâmetros:
     • q (string, obrigatório): Consulta de pesquisa
     • page (integer, opcional): Número da página
     • size (integer, opcional): Número de resultados de pesquisa a retornar por página (1-10)
     • sort (string, opcional): Expressão de ordenação (apenas 'date' é suportado)
     • safe (boolean, opcional): Ativar filtro de pesquisa segura
     • lr (string, opcional): Restringir a pesquisa a um idioma específico (ex.: lang_en)
     • siteRestricted (boolean, opcional): Usar o endpoint da API Site Restricted; o padrão é true, a menos que seja substituído pela flag da CLI

Exemplo 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
    }
)

Links Úteis

• Servidores Model Context Protocol
• Introdução ao Google Programmable Search Engine