Home
Login

Um conector de servidor de protocolo de contexto de modelo para a API Perplexity, permitindo funcionalidades de pesquisa na web sem sair do ecossistema MCP.

MITJavaScript 1.3kppl-aimodelcontextprotocol Last Updated: 2025-04-27

Protocolo de Contexto do Modelo - Conector da API Perplexity

Visão Geral do Projeto

O Protocolo de Contexto do Modelo (MCP) é um projeto inovador de implementação de servidor, projetado especificamente para integrar a API Sonar da Perplexity. O objetivo principal deste projeto é fornecer aos assistentes de IA, como o Claude, capacidades incomparáveis de pesquisa na web em tempo real, permitindo que os usuários obtenham as informações mais recentes da web sem sair do ecossistema MCP.

Endereço do Projeto: https://github.com/ppl-ai/modelcontextprotocol

Licença: Licença MIT

Funcionalidades e Características Principais

🌐 Pesquisa na Web em Tempo Real

  • Integração da API Sonar: Integração direta com o poderoso mecanismo de busca da Perplexity
  • Obtenção de Informações em Tempo Real: Fornece as informações da web mais recentes e precisas
  • Experiência Contínua: Conclui todas as operações de pesquisa dentro do ecossistema MCP

🛠️ Amigável ao Desenvolvedor

  • Múltiplas Formas de Implantação: Suporta implantação em contêineres Docker e instalação direta via NPM
  • Suporte a TypeScript: Desenvolvido em TypeScript, oferecendo melhor segurança de tipo
  • Configuração Flexível: Permite personalizar parâmetros de pesquisa e configurações de chamadas de API

🔧 Ferramentas e Interfaces

Ferramenta perplexity_ask

Esta ferramenta é a funcionalidade central do projeto, oferecendo as seguintes capacidades:

Descrição da Funcionalidade: Interage de forma conversacional com a API Sonar, permitindo pesquisa na web em tempo real

Parâmetros de Entrada:

  • messages (array): Array de mensagens de diálogo
    • role (string): Papel da mensagem (ex: system, user, assistant)
    • content (string): Conteúdo da mensagem

🖥️ Plataformas Suportadas

Claude Desktop

  • Integração Nativa: Suporte perfeito para o aplicativo de desktop Claude
  • Configuração Simples: Habilitado através de um arquivo de configuração JSON
  • Visualização da Ferramenta: Exibe um ícone de martelo na interface, indicando que a ferramenta está ativada

Cursor IDE

  • Integração com o Ambiente de Desenvolvimento: Suporta o editor de código Cursor
  • Servidor MCP Global: Pode ser configurado como uma ferramenta globalmente disponível
  • Fluxo de Trabalho do Desenvolvedor: Integra-se perfeitamente ao fluxo de trabalho diário dos desenvolvedores

Começando Rapidamente

Preparação do Ambiente

  1. Obtenha uma Chave de API

    • Registre-se para uma Conta da API Sonar
    • Gere uma chave de API no painel do desenvolvedor
    • Defina a variável de ambiente PERPLEXITY_API_KEY
  2. Instale o Projeto

    git clone git@github.com:ppl-ai/modelcontextprotocol.git
    cd modelcontextprotocol/perplexity-ask
    npm install
    

Opções de Implantação

Opção 1: Implantação com Docker

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "PERPLEXITY_API_KEY",
        "mcp/perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "SUA_CHAVE_DE_API_AQUI"
      }
    }
  }
}

Opção 2: Execução Direta com NPM

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": ["-y", "server-perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "SUA_CHAVE_DE_API_AQUI"
      }
    }
  }
}

Arquitetura Técnica

Componentes do Sistema

  • Servidor MCP: Componente de serviço central, lida com a comunicação do protocolo
  • Cliente da API Sonar: Camada de interface com a API Perplexity
  • Processador de Mensagens: Processa mensagens de diálogo e solicitações de pesquisa
  • Gerenciamento de Configuração: Sistema de configuração de parâmetros flexível

Fluxo de Dados

  1. Recebimento da Solicitação: Claude ou outros clientes enviam solicitações de pesquisa
  2. Processamento da Mensagem: O servidor MCP analisa as mensagens de diálogo
  3. Chamada da API: Envia solicitações de pesquisa para a API Sonar
  4. Retorno do Resultado: Resultados de pesquisa em tempo real são retornados ao cliente

Casos de Uso

📚 Pesquisa e Aprendizado

  • Consulta de Informações em Tempo Real: Obtenha as últimas notícias e desenvolvimentos técnicos
  • Pesquisa Acadêmica: Encontre rapidamente literatura e materiais relevantes
  • Verificação de Fatos: Verifique a precisão e a atualidade das informações

💼 Aplicações Comerciais

  • Análise de Mercado: Obtenha as últimas tendências de mercado e informações sobre a concorrência
  • Atendimento ao Cliente: Forneça aos clientes as informações mais recentes sobre produtos e soluções
  • Criação de Conteúdo: Obtenha as informações mais recentes para a criação de conteúdo

🛠️ Ferramentas para Desenvolvedores

  • Consulta de Documentação Técnica: Encontre rapidamente a documentação técnica e informações da API mais recentes
  • Resolução de Problemas: Encontre as soluções e as melhores práticas mais recentes
  • Acompanhamento de Tendências: Entenda as tendências de desenvolvimento tecnológico e as tecnologias emergentes

Personalização e Extensão

Configuração de Parâmetros de Pesquisa

O projeto permite que os desenvolvedores modifiquem diretamente os parâmetros de pesquisa no arquivo index.ts, incluindo:

  • Configurações do modo de pesquisa
  • Limite do número de resultados
  • Configurações de preferência de idioma
  • Filtragem de intervalo de tempo

Vantagens do Projeto

✅ Código Aberto e Transparente

  • Licença MIT: Totalmente de código aberto, pode ser usado, modificado e distribuído livremente
  • Impulsionado pela Comunidade: Contribuidores são bem-vindos para participar do desenvolvimento do projeto

✅ Fácil de Integrar

  • Protocolo Padronizado: Baseado no padrão MCP, alta compatibilidade
  • Suporte a Múltiplas Plataformas: Suporta vários assistentes de IA e ambientes de desenvolvimento

✅ Altamente Personalizável

  • Configuração Flexível: Suporta várias personalizações de parâmetros de pesquisa
  • Alta Escalabilidade: Pode ser estendido funcionalmente de acordo com as necessidades

Resumo

O Protocolo de Contexto do Modelo - Conector da API Perplexity é um projeto de código aberto poderoso e fácil de usar que fornece aos assistentes de IA poderosas capacidades de pesquisa na web em tempo real. Ao integrar a API Sonar da Perplexity, este projeto permite que os usuários obtenham as informações da web mais recentes e precisas sem sair de seu ambiente de trabalho atual.

Seja para pesquisa e aprendizado, aplicações comerciais ou trabalho de desenvolvimento, este projeto pode melhorar significativamente a praticidade e a precisão dos assistentes de IA. Suas características de código aberto e opções de configuração flexíveis o tornam uma escolha ideal para desenvolvedores e empresas.

Público Alvo:

  • Desenvolvedores de aplicativos de IA
  • Pesquisadores e acadêmicos
  • Criadores de conteúdo
  • Usuários corporativos que precisam de informações em tempo real

Valor Central:

  • Melhora a capacidade de obtenção de informações dos assistentes de IA
  • Simplifica o processo de integração de pesquisa em tempo real
  • Fornece uma fonte de informações da web confiável e precisa

Star History Chart