Claude Web Search

Fornece funcionalidade de pesquisa na web alimentada pela API Claude da Anthropic.

Documentação

Claude Web Search MCP Server

Este servidor MCP (Model Context Protocol) fornece recursos de pesquisa na web usando a API Claude. Ele permite que LLMs acessem informações atualizadas da web por meio de uma interface padronizada.

Recursos

  • Ferramenta de pesquisa na web usando a API de pesquisa web da Claude
  • Suporte para filtragem de domínios (domínios permitidos e bloqueados)
  • Máximo de resultados configurável por pesquisa
  • Configuração automática a partir do arquivo de configuração do Claude Desktop

Pré-requisitos

  • Node.js 18 ou superior
  • Uma chave de API Anthropic com pesquisa na web habilitada
  • Aplicativo Claude Desktop para testes

Instalação e Configuração

  1. Clone o repositório:

    git clone https://github.com/Doriandarko/claude-search-mcp.git
    cd claude-search-mcp
    
  2. Instale as dependências:

    npm install
    
  3. Compile o servidor:

    npm run build
    

    Isso compila o código TypeScript e torna o servidor executável.

  4. Vincule o servidor para acesso global:

    npm link
    

    Isso torna o comando mcp-server-claude-search disponível em todo o sistema, permitindo que o aplicativo Claude Desktop o encontre.

Executando o Servidor com o Aplicativo Claude Desktop

Depois que o servidor estiver instalado e vinculado, o aplicativo Claude Desktop pode gerenciá-lo automaticamente se estiver configurado corretamente.

  1. Configure o aplicativo Claude Desktop: Abra o arquivo de configuração do servidor MCP do seu aplicativo Claude Desktop (geralmente claude_desktop_config.json). Adicione ou atualize a entrada para este servidor:

    {
      "mcpServers": {
        // ... other servers ...
        "claude-search": {
          "command": "mcp-server-claude-search",
          "env": {
            "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE"
          }
        }
        // ... other servers ...
      }
    }
    

    Substitua "YOUR_ANTHROPIC_API_KEY_HERE" pela sua chave de API Anthropic real. O servidor também tentará ler esta chave de ~/code/claude-search-mcp/claude_desktop_config.json se a variável env não estiver definida aqui, mas é uma boa prática defini-la por servidor na configuração principal.

  2. Inicie o aplicativo Claude Desktop: Inicie (ou reinicie) seu aplicativo Claude Desktop. Ele agora deve ser capaz de encontrar e iniciar o mcp-server-claude-search quando necessário.

  3. Use a Pesquisa na Web: Agora você pode usar os recursos de pesquisa na web em suas conversas com o Claude.

Execução Manual do Servidor (para testes/desenvolvimento)

Se você quiser executar o servidor manualmente para fins de teste ou desenvolvimento (fora do gerenciamento do aplicativo Claude Desktop):

  • Usando o comando vinculado globalmente:
    mcp-server-claude-search
    
  • Diretamente com tsx (para desenvolvimento com reinicialização automática):
    npm run dev
    
  • Executando o código compilado diretamente:
    npm start
    

Parâmetros da Ferramenta de Pesquisa na Web

A ferramenta de pesquisa na web suporta os seguintes parâmetros quando chamada por um LLM:

  • query (obrigatório): A string de consulta de pesquisa.
  • maxResults (opcional): Número máximo de resultados de pesquisa a retornar (padrão: 5).
  • allowedDomains (opcional): Array de domínios a incluir nos resultados da pesquisa (por exemplo, ["example.com", "wikipedia.org"]).
  • blockedDomains (opcional): Array de domínios a excluir dos resultados da pesquisa.

Licença

MIT