Local Research MCP Server

Um assistente de pesquisa privado e local que pesquisa na web e extrai conteúdo usando DuckDuckGo.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Local Research MCP Server

Um assistente de pesquisa gratuito e privado para ambientes de desenvolvimento de IA que pesquisa na web e extrai conteúdo usando DuckDuckGo e Python. Este servidor MCP dá aos assistentes de IA a capacidade de acessar informações em tempo real, mantendo todo o processamento local para privacidade completa.

Compatível com:

  • Claude Desktop - O aplicativo de desktop oficial da Anthropic
  • Claude Code - A ferramenta CLI da Anthropic para desenvolvedores
  • Gemini CLI - A ferramenta CLI do Gemini
  • Cline - Extensão do VS Code para codificação com IA
  • Qualquer cliente compatível com MCP

Recursos

  • 🔍 Pesquisa Web Gratuita: Usa a API de pesquisa do DuckDuckGo sem exigir chaves de API
  • 📄 Extração de Conteúdo: Extrai texto limpo de páginas web de forma inteligente
  • 🔒 Privacidade em Primeiro Lugar: Todo o processamento acontece localmente na sua máquina
  • ⚡ Integração Rápida: Funciona perfeitamente com Claude Desktop via MCP
  • 🛠️ Zero Dependências: Sem serviços externos ou assinaturas necessárias

Início Rápido

Pré-requisitos

  • Python 3.10 ou superior
  • Um dos ambientes de IA compatíveis:
    • Claude Desktop, Claude Code, Google CLI, Cline ou outro cliente MCP
  • Conhecimento básico de linha de comando

Instalação

  1. Clone este repositório:

    git clone https://github.com/Unlock-MCP/local-research-server.git
cd local-research-server

  2. Configure o ambiente:

    uv init
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

  3. Instale as dependências:

    uv add "mcp[cli]" duckduckgo-search trafilatura

  4. Teste o servidor:

    python research_server.py

Configuração

Escolha seu ambiente de IA:

Claude Desktop

Adicione isto ao seu arquivo de configuração:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "local-researcher": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local-research-server",
        "run",
        "python",
        "research_server.py"
      ]
    }
  }
}

Claude Code

Adicione isto ao seu arquivo CLAUDE.md ou use a CLI:

claude --mcp-server local-researcher="uv --directory /path/to/your/local-research-server run python research_server.py"

Google AI Studio / Gemini CLI

Configure através das configurações do seu cliente MCP ou variáveis de ambiente.

Cline (VS Code)

Adicione à configuração do servidor MCP do Cline nas configurações do VS Code.

Substitua /path/to/your/local-research-server pelo caminho completo para este diretório.

Uso

Após a configuração, reinicie seu ambiente de IA. Os indicadores de conexão variam por plataforma:

  • Claude Desktop: Procure pelo ícone de plugue (🔌)
  • Claude Code: O status do servidor aparece na saída da CLI
  • Outras plataformas: Verifique o status de conexão do seu cliente MCP

Faça perguntas de pesquisa ao seu assistente de IA, como:

  • "Quais são os últimos desenvolvimentos em pesquisa de IA esta semana?"
  • "Pesquise as tendências atuais de energia renovável na Europa"
  • "Encontre relatórios recentes de ameaças de segurança cibernética"

Seu assistente de IA usará automaticamente o servidor local para buscar informações em tempo real.

Como Funciona

O servidor implementa uma única ferramenta MCP que:

  1. Pesquisa na web usando a API gratuita do DuckDuckGo
  2. Extrai conteúdo dos principais resultados de pesquisa
  3. Extrai texto limpo e legível usando Trafilatura
  4. Retorna conteúdo formatado para Claude para análise

Todo o processamento acontece localmente, sem envio de dados para serviços externos, exceto pelas pesquisas web públicas.

Arquitetura

AI Client (Claude Desktop/Code/Gemini/Cline)
    ↓ (MCP Protocol)
Local Research Server
    ↓ (Search API)
DuckDuckGo Search
    ↓ (HTTP Requests)
Target Websites
    ↓ (Content Extraction)
Clean Text → AI Assistant

Opções de Configuração

O servidor aceita estes parâmetros para a ferramenta de pesquisa:

  • query (string): A consulta de pesquisa ou tópico de pesquisa
  • num_results (int): Número de resultados de pesquisa a processar (padrão: 3)

Recursos de Segurança

  • Validação de Entrada: Sanitiza consultas de pesquisa
  • Limitação de Taxa: Atrasos educados entre solicitações web
  • Tratamento de Erros: Tratamento gracioso de falhas
  • Processamento Local: Sem dependências externas de dados

Aplicações de Negócios

Este servidor de pesquisa é ideal para:

  • Criação de Conteúdo: Escrita de artigos baseada em pesquisa
  • Análise de Mercado: Pesquisa em tempo real de concorrentes e do setor
  • Due Diligence: Pesquisa de empresas e investimentos
  • Monitoramento Regulatório: Acompanhamento de requisitos de conformidade

Estendendo o Servidor

Considere estas melhorias:

  • Adicionar integração com feeds RSS
  • Implementar cache de resultados de pesquisa
  • Adicionar capacidades de filtragem por domínio
  • Incluir extração de data de publicação
  • Adicionar suporte a múltiplos mecanismos de busca

Solução de Problemas

Problemas Comuns

Servidor não conectando:

  • Verifique o caminho absoluto na configuração do seu cliente de IA
  • Reinicie completamente seu ambiente de IA
  • Verifique se as dependências do Python estão instaladas

Sem resultados de pesquisa:

  • Verifique a conexão com a internet
  • Verifique o status do serviço DuckDuckGo
  • Tente consultas de pesquisa diferentes

Falha na extração de conteúdo:

  • Alguns sites bloqueiam a extração
  • Tente termos de pesquisa diferentes para fontes variadas
  • Verifique a saída do console para erros específicos

Contribuindo

Aceitamos contribuições! Consulte nosso Guia de Contribuição para detalhes.

Licença

Licença MIT - consulte LICENÇA para detalhes.

Projetos Relacionados

Suporte