SearXNG MCP Server

Servidor MCP SearXNG

Uma implementação de servidor MCP que integra a API do SearXNG, fornecendo recursos de busca na web.

Recursos

• Busca na Web: Consultas gerais, notícias, artigos, com paginação.
• Paginação: Controle qual página de resultados recuperar.
• Filtro por Tempo: Filtre resultados por intervalo de tempo (dia, mês, ano).
• Seleção de Idioma: Filtre resultados pelo idioma preferido.
• Busca Segura: Controle o nível de filtragem de conteúdo para os resultados da busca.

Ferramentas

• searxng_web_search

  • Executa buscas na web com paginação
  • Entradas:
    • query (string): A consulta de busca. Esta string é passada para serviços de busca externos.
    • pageno (número, opcional): Número da página de busca, começa em 1 (padrão 1)
    • time_range (string, opcional): Filtra resultados por intervalo de tempo - um de: "day", "month", "year" (padrão: nenhum)
    • language (string, opcional): Código do idioma para resultados (ex.: "en", "fr", "de") ou "all" (padrão: "all")
    • safesearch (número, opcional): Nível do filtro de busca segura (0: Nenhum, 1: Moderado, 2: Estrito) (padrão: configuração da instância)

• web_url_read

  • Lê e converte o conteúdo de uma URL para markdown
  • Entradas:
    • url (string): A URL para buscar e processar

Configuração

Definindo o SEARXNG_URL

1. Escolha uma instância do SearxNG na lista de instâncias públicas ou use seu ambiente local.
2. Defina a variável de ambiente SEARXNG_URL para a URL da instância.
3. O valor padrão de SEARXNG_URL é http://localhost:8080.

Usando Autenticação

Se você estiver usando uma instância do SearxNG protegida por senha, você pode definir um nome de usuário e senha para Autenticação Básica HTTP:

• Defina a variável de ambiente AUTH_USERNAME para o seu nome de usuário
• Defina a variável de ambiente AUTH_PASSWORD para a sua senha

Uso com Claude Desktop

NPX

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

NPM

npm install -g mcp-searxng

E então no seu arquivo de configuração MCP:

{
  "mcpServers": {
    "searxng": {
      "command": "mcp-searxng",
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Docker

Usando Imagem Pré-construída do Docker Hub

docker pull isokoliuk/mcp-searxng:latest

Adicione isso ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "isokoliuk/mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Compilar Localmente

docker build -t mcp-searxng:latest -f Dockerfile .

Usar

Adicione isso ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Licença

Este servidor MCP é 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.