Serper MCP Server

Acesse os resultados da Pesquisa Google usando a API Serper.

Documentação

Serper MCP Server

PyPI version PyPI Downloads Monthly Downloads Python Version

Um servidor Model Context Protocol que fornece Google Search via Serper. Este servidor permite que LLMs obtenham informações de resultados de busca do Google.

Ferramentas Disponíveis

Uso

Instalando via Smithery

Para instalar o Serper MCP Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @garylab/serper-mcp-server --client claude

Usando uv (recomendado)

  1. Certifique-se de que você instalou uv no seu sistema operacional.

  2. Na configuração do código do seu cliente MCP ou nas configurações do Claude (arquivo claude_desktop_config.json), adicione o servidor mcp serper:

    {
        "mcpServers": {
            "serper": {
                "command": "uvx",
                "args": ["serper-mcp-server"],
                "env": {
                    "SERPER_API_KEY": "<Your Serper API key>"
                }
            }
        }
    }
    

    uv baixará o servidor mcp automaticamente usando uvx do pypi.org e o aplicará ao seu cliente MCP.

Usando pip para projeto

  1. Adicione serper-mcp-server ao arquivo requirements.txt do código do seu cliente MCP.

    serper-mcp-server
    
  2. Instale as dependências.

    pip install -r requirements.txt
    
  3. Adicione a configuração para o seu cliente:

    {
        "mcpServers": {
            "serper": {
                "command": "python3",
                "args": ["-m", "serper_mcp_server"],
                "env": {
                    "SERPER_API_KEY": "<Your Serper API key>"
                }
            }
        }
    }
    

Usando pip para uso global

  1. Certifique-se de que o pip ou pip3 esteja no seu sistema operacional.

    pip install serper-mcp-server
    # or
    pip3 install serper-mcp-server
    
  2. Na configuração do código do cliente MCP ou nas configurações do Claude, adicione o servidor mcp serper:

    {
        "mcpServers": {
            "serper": {
                "command": "python3",
                "args": ["serper-mcp-server"],
                "env": {
                    "SERPER_API_KEY": "<Your Serper API key>"
                }
            }
        }
    }
    

Depuração

Você pode usar o inspetor MCP para depurar o servidor. Para instalações uvx:

npx @modelcontextprotocol/inspector uvx serper-mcp-server

Ou se você instalou o pacote em um diretório específico ou está desenvolvendo nele:

git clone https://github.com/garylab/serper-mcp-server.git
cd serper-mcp-server
npx @modelcontextprotocol/inspector uv run serper-mcp-server -e SERPER_API_KEY=<the key>

Licença

serper-mcp-server é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.