MewCP Perplexity MCP

Servidor MCP Perplexity hospedado, sem estado e multilocatário que permite que assistentes de IA realizem pesquisas na web e obtenham resultados de busca com tecnologia de IA através do Perplexity.

GitHubExperimente este MCPPatrocinado

Documentação

Responda qualquer pergunta com busca web ao vivo, citações e raciocínio de IA — tudo em uma única chamada.

Um servidor Model Context Protocol (MCP) que expõe a API da Perplexity AI para busca web em tempo real e consultas conversacionais com fontes citadas.

Visão Geral

O Perplexity MCP Server fornece busca web com IA e respostas fundamentadas com citações:

  • Consulte a web ao vivo e obtenha respostas sintetizadas por LLM com referências de fontes
  • Controle o comprimento da resposta, a temperatura e o modelo de busca subjacente
  • Navegue pelos modelos Perplexity disponíveis para escolher a capacidade certa para cada tarefa

Perfeito para:

  • Dar aos assistentes de IA acesso a eventos atuais, notícias e informações em tempo real
  • Responder perguntas de pesquisa que exigem fatos atualizados além do corte de treinamento do modelo
  • Enriquecer fluxos de trabalho de IA com fontes web citadas e verificáveis

Ferramentas

health_check — Verifica a prontidão do servidor

Retorna um objeto de status confirmando que o servidor está em execução e acessível.

Entradas: (nenhuma)

Saída:

{
  "status": "ok",
  "server": "CL Perplexity MCP Server"
}
search — Pesquisa na web com Perplexity AI

Envia uma consulta aos modelos de busca online da Perplexity e retorna uma resposta gerada por LLM com citações de fontes web ao vivo.

Entradas:

- `query`       (string, required)  — Search query to look up on the web
- `model`       (string, optional)  — Model to use (default: llama-3.1-sonar-small-128k-online)
- `max_tokens`  (integer, optional) — Maximum tokens in the response, 1–4096
- `temperature` (float, optional)   — Sampling temperature 0–2; higher = more creative (default: model default)

Saída:

{
  "success": true,
  "query": "latest AI research papers 2025",
  "response": "Recent AI research has focused on...",
  "model": "llama-3.1-sonar-small-128k-online",
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 320,
    "total_tokens": 332
  }
}
get_models — Lista os modelos Perplexity disponíveis

Retorna todos os modelos disponíveis através da API da Perplexity, agrupados em categorias online (busca web) e offline (sem busca).

Entradas: (nenhuma)

Saída:

{
  "success": true,
  "total_models": 6,
  "online_models": [
    "llama-3.1-sonar-small-128k-online",
    "llama-3.1-sonar-large-128k-online",
    "llama-3.1-sonar-huge-128k-online"
  ],
  "other_models": [
    "llama-3.1-sonar-small-128k-chat",
    "llama-3.1-sonar-large-128k-chat"
  ],
  "all_models": [...]
}

Referência de Parâmetros da API

Seleção de Modelo

Modelos online (incluem busca web ao vivo):

  • llama-3.1-sonar-small-128k-online — Rápido e econômico; padrão para busca web
  • llama-3.1-sonar-large-128k-online — Respostas de maior qualidade, busca mais completa
  • llama-3.1-sonar-huge-128k-online — Melhor qualidade, mais abrangente; custo mais alto

Use get_models para obter a lista completa atual — novos modelos são adicionados periodicamente.

Parâmetros de Geração
  • temperature — Controla a aleatoriedade; 0.0 para respostas factuais focadas, 1.0+ para respostas criativas (intervalo: 0–2)
  • max_tokens — Limita o comprimento da resposta; útil para controlar custo e latência (intervalo: 1–4096)

Obtendo Sua Chave de API Perplexity

Passos
  1. Acesse as Configurações da API Perplexity
  2. Entre ou crie uma conta Perplexity
  3. Em API Keys, clique em + Generate
  4. Copie a chave gerada — guarde-a com segurança, ela não será exibida novamente

O uso da API Perplexity é cobrado por requisição com base no modelo e na contagem de tokens. Modelos online consomem créditos adicionais para busca web.

Solução de Problemas

Cabeçalhos Ausentes ou Inválidos
  • Causa: chave de API não fornecida nos cabeçalhos da requisição ou formato incorreto
  • Solução:
    1. Verifique se os cabeçalhos Authorization: Bearer YOUR_API_KEY e X-Mewcp-Credential-Id: CREDENTIAL-ID estão presentes
    2. Verifique se a chave de API está ativa na sua conta MewCP
Créditos Insuficientes
  • Causa: as chamadas de API excederam seus limites de requisição
  • Solução:
    1. Verifique o uso de créditos no seu painel Curious Layer
    2. Faça upgrade para um plano pago ou adicione créditos para limites maiores
    3. Entre em contato com o suporte para ajustes de crédito
Credencial Não Conectada
  • Causa: nenhuma credencial Perplexity vinculada à sua conta
  • Solução:
    1. Acesse Credentials no seu painel MewCP
    2. Adicione sua chave de API Perplexity
    3. Tente novamente a requisição com o cabeçalho X-Mewcp-Credential-Id correto
Payload de Requisição Malformado
  • Causa: o payload JSON é inválido ou está faltando campos obrigatórios
  • Solução:
    1. Valide a sintaxe JSON antes de enviar
    2. Garanta que o parâmetro query esteja incluído e seja uma string não vazia
    3. Verifique se temperature está entre 0.0 e 2.0 e se max_tokens está entre 1 e 4096
Servidor Não Encontrado
  • Causa: nome de servidor incorreto no endpoint da API
  • Solução:
    1. Verifique o formato do endpoint: {server-name}/mcp/{tool-name}
    2. Use o nome de servidor correto da documentação
    3. Verifique os servidores disponíveis na sua conta Curious Layer
Erro da API Perplexity
  • Causa: a API Perplexity upstream retornou um erro
  • Solução:
    1. Verifique o status do serviço Perplexity na Página de Status da Perplexity
    2. Verifique se sua chave de API tem créditos suficientes para o modelo selecionado
    3. Revise a mensagem de erro para detalhes específicos (ex.: limite de taxa excedido, ID de modelo inválido)
Recursos