Perplexity Search

Acesse a API de busca do Perplexity para obter informações e respostas em tempo real.

Documentação

Servidor MCP Perplexity Search

License: MIT

Uma implementação em Go de um servidor MCP Perplexity Search que permite que modelos de linguagem de grande porte (LLMs) acessem a API de busca da Perplexity através do Model Context Protocol (MCP).

Recursos

  • perplexity_search: Realiza buscas na web e retorna resultados, incluindo citações
    • Parâmetros:
      • query (string, obrigatório): A consulta de busca
      • search_recency_filter (string, opcional): Filtra resultados por período (month, week, day, hour)
      • max_tokens (inteiro, opcional): Número máximo de tokens a retornar
      • temperature (número, opcional, padrão: 0.2): Controla a aleatoriedade na resposta
      • top_p (número, opcional, padrão: 0.9): Limiar de amostragem por núcleo
      • search_domain_filter (array, opcional): Lista de domínios para limitar os resultados da busca
      • return_images (booleano, opcional): Incluir links de imagens nos resultados
      • return_related_questions (booleano, opcional): Incluir perguntas relacionadas
      • top_k (número, opcional, padrão: 0): Número de tokens para filtragem top-k
      • stream (booleano, opcional): Transmitir resposta incrementalmente
      • presence_penalty (número, opcional, padrão: 0): Ajusta a probabilidade de novos tópicos
      • frequency_penalty (número, opcional, padrão: 1): Reduz repetição
      • web_search_options (objeto, opcional): Opções de configuração para busca na web

Configuração e Uso

Instalação via Smithery

Para instalar o Perplexity Search Golang para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @chenxilol/perplexity-mcp-go --client claude

Pré-requisitos

  • Go 1.23 ou superior
  • Chave da API Perplexity

Instalação

  1. Clone o repositório:
git clone https://github.com/chenxilol/perplexity-mcp-go.git
cd perplexity-mcp-go
  1. Compile a aplicação:
go build -o perplexity-search-mcp

Executando Localmente

  1. Defina sua chave da API Perplexity:
export PERPLEXITY_API_KEY="your-api-key-here"
  1. Execute o servidor:
./perplexity-search-mcp

Integração com Claude

  1. Copie o claude_desktop_config.json fornecido para o diretório de configuração do Claude:

    • Windows: %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Edite o arquivo de configuração para incluir sua chave da API:

{
  "mcpServers": {
    "perplexity-search": {
      "command": "/path/to/perplexity-search-mcp",
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Suporte a Docker

  1. Compile a imagem Docker:
docker build -t perplexity-search-mcp:latest .
  1. Execute o contêiner:
docker run -i --rm -e PERPLEXITY_API_KEY=your-api-key-here perplexity-search-mcp:latest

Exemplo de Uso

Após a configuração, o Claude pode usar a ferramenta perplexity_search via MCP para realizar buscas na web em tempo real.

Exemplo de busca com parâmetros:

{
  "query": "latest AI research developments",
  "search_recency_filter": "week",
  "temperature": 0.5,
  "return_related_questions": true,
  "web_search_options": {
    "search_context_size": "high"
  }
}

Solução de Problemas

Se você encontrar problemas:

  1. Verifique se sua chave da API está configurada corretamente
  2. Verifique a conectividade de rede
  3. Examine os logs de stderr para mensagens de erro

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos