Perplexity MCP Zerver

Perplexity MCP Zerver

Um servidor de pesquisa minimalista que implementa o Model Context Protocol (MCP) para fornecer capacidades de pesquisa com tecnologia de IA através da interface web da Perplexity.

Capacidades de Pesquisa

• Pesquisa Web Inteligente: Busque e resuma conteúdo sem limites de API
• Conversas Persistentes: Mantenha contexto com armazenamento local de chat em SQLite
• Extração de Conteúdo: Extração limpa de artigos com parsing de repositórios GitHub
• Ferramentas para Desenvolvedores: Recuperação de documentação, descoberta de APIs, análise de código
• Operação sem Chaves: Automação de navegador substitui a necessidade de chaves de API

---

Ferramentas Disponíveis

Pesquisa (search)

Execute consultas de pesquisa com profundidade configurável
Retorna resultados em texto bruto

Obter Documentação (get_documentation)

Recupere documentação técnica com exemplos
Retorna documentação estruturada

Encontrar APIs (find_apis)

Descubra APIs relevantes para necessidades de desenvolvimento
Retorna listagens e descrições de APIs

Verificar Código Obsoleto (check_deprecated_code)

Analise trechos de código para padrões desatualizados
Retorna relatório de análise

Extrair Conteúdo de URL (extract_url_content)

Parseie conteúdo web com tratamento automático de GitHub
Retorna metadados estruturados de conteúdo

Chat (chat_perplexity)

Conversas persistentes com histórico de contexto
Retorna estado da conversa em formato JSON

---

Começando

Pré-requisitos

• Runtime Bun
• Node.js 18+ (para compilação TypeScript)

Instalação

git clone https://github.com/wysh3/perplexity-mcp-zerver.git
cd perplexity-mcp-zerver
bun install
bun run build

Configuração

Adicione ao seu arquivo de configuração MCP:

{
  "mcpServers": {
    "perplexity-server": {
      "command": "bun",
      "args": ["/absolute/path/to/build/main.js"],
      "timeout": 300
    }
  }
}

Uso

Inicie comandos através do seu cliente MCP:

• "Use perplexity para pesquisar avanços em computação quântica"
• "Peça ao perplexity-server documentação sobre React 18"
• "Inicie conversa com perplexity sobre redes neurais"

---

🔐 Suporte a Conta Pro (Opcional)

Use sua assinatura Perplexity Pro para acesso a modelos melhores (GPT-5.1, Claude Sonnet 4.5) e limites mais altos.

Configuração Única

bun run build
bun run login

Uma janela do navegador será aberta. Faça login usando e-mail (recomendado para melhor compatibilidade) e feche o navegador. Sua sessão está salva!

Nota: O login com Google/SSO pode funcionar, mas o login por e-mail é mais confiável com a automação do navegador.

Variáveis de Ambiente

Variável	Padrão	Descrição
PERPLEXITY_BROWSER_DATA_DIR	~/.perplexity-mcp	Diretório do perfil do navegador
PERPLEXITY_PERSISTENT_PROFILE	true	Defina como false para modo anônimo

---

Comparação Técnica

Recurso	Esta Implementação	APIs Tradicionais
Autenticação	Nenhuma necessária	Chaves de API
Custo	Gratuito	Baseado no uso
Privacidade de Dados	Processamento local	Servidores remotos
Integração GitHub	Suporte nativo	Limitada
Persistência de Histórico	Armazenamento SQLite	Baseado em sessão

---

Solução de Problemas

Problemas de Conexão com o Servidor

1. Verifique o caminho absoluto na configuração
2. Confirme a instalação do Node.js com node -v
3. Garanta que o build foi concluído com sucesso

Extração de Conteúdo

• Caminhos do GitHub devem usar URLs completas do repositório
• Ajuste a profundidade de recursão de links na configuração da fonte

---

Origens e Licença

baseado em - DaInfernalCoder/perplexity-researcher-mcp
refatorado de - sm-moshi/docshunter

Licenciado sob GNU GPL v3.0 - Ver Licença

---

Este projeto interage com a Perplexity via automação de navegador. Use com responsabilidade e ética. A estabilidade depende da consistência do site da Perplexity. Apenas para uso educacional.