Perplexity Search

Pesquisa na web e conclusão de chat alimentados pela API do Perplexity AI.

GitHub
8
Experimente este MCPPatrocinado

Documentação

mcp-perplexity-search

⚠️ Aviso

Este repositório não é mais mantido.

A funcionalidade desta ferramenta agora está disponível em mcp-omnisearch, que combina múltiplas ferramentas MCP em um pacote unificado.

Por favor, use mcp-omnisearch em vez disso.

Um servidor Model Context Protocol (MCP) para integrar a API de IA da Perplexity com LLMs. Este servidor fornece capacidades avançadas de conclusão de chat com modelos de prompt especializados para vários casos de uso.

Recursos

  • 🤖 Conclusão de chat avançada usando os modelos de IA da Perplexity
  • 📝 Modelos de prompt predefinidos para cenários comuns:
    • Geração de documentação técnica
    • Análise de melhores práticas de segurança
    • Revisão e melhorias de código
    • Documentação de API em formato estruturado
  • 🎯 Suporte a modelos personalizados para casos de uso especializados
  • 📊 Múltiplos formatos de saída (texto, markdown, JSON)
  • 🔍 Inclusão opcional de URLs de fonte nas respostas
  • ⚙️ Parâmetros de modelo configuráveis (temperatura, máximo de tokens)
  • 🚀 Suporte a vários modelos Perplexity, incluindo Sonar e LLaMA

Configuração

Este servidor requer configuração através do seu cliente MCP. Aqui estão exemplos para diferentes ambientes:

Configuração do Cline

Adicione isto às suas configurações MCP do Cline:

{
	"mcpServers": {
		"mcp-perplexity-search": {
			"command": "npx",
			"args": ["-y", "mcp-perplexity-search"],
			"env": {
				"PERPLEXITY_API_KEY": "your-perplexity-api-key"
			}
		}
	}
}

Configuração do Claude Desktop com WSL

Para ambientes WSL, adicione isto à sua configuração do Claude Desktop:

{
	"mcpServers": {
		"mcp-perplexity-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
			]
		}
	}
}

Variáveis de Ambiente

O servidor requer a seguinte variável de ambiente:

  • PERPLEXITY_API_KEY: Sua chave de API da Perplexity (obrigatória)

API

O servidor implementa uma única ferramenta MCP com parâmetros configuráveis:

chat_completion

Gera conclusões de chat usando a API da Perplexity com suporte para modelos de prompt especializados.

Parâmetros:

  • messages (array, obrigatório): Array de objetos de mensagem com:
    • role (string): 'system', 'user' ou 'assistant'
    • content (string): O conteúdo da mensagem
  • prompt_template (string, opcional): Modelo predefinido a usar:
    • technical_docs: Documentação técnica com exemplos de código
    • security_practices: Diretrizes de implementação de segurança
    • code_review: Análise e melhorias de código
    • api_docs: Documentação de API em formato JSON
  • custom_template (objeto, opcional): Modelo de prompt personalizado com:
    • system (string): Mensagem de sistema para o comportamento do assistente
    • format (string): Preferência de formato de saída
    • include_sources (booleano): Se deve incluir fontes
  • format (string, opcional): 'text', 'markdown' ou 'json' (padrão: 'text')
  • include_sources (booleano, opcional): Incluir URLs de fonte (padrão: false)
  • model (string, opcional): Modelo Perplexity a usar (padrão: 'sonar')
  • temperature (número, opcional): Aleatoriedade da saída (0-1, padrão: 0.7)
  • max_tokens (número, opcional): Comprimento máximo da resposta (padrão: 1024)

Desenvolvimento

Instalação

  1. Clone o repositório
  2. Instale as dependências:
pnpm install
  1. Compile o projeto:
pnpm build
  1. Execute em modo de desenvolvimento:
pnpm dev

Publicação

O projeto usa changesets para gerenciamento de versão. Para publicar:

  1. Crie um changeset:
pnpm changeset
  1. Versione o pacote:
pnpm changeset version
  1. Publique no npm:
pnpm release

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Licença MIT - veja o arquivo LICENSE para detalhes.

Agradecimentos