Home
Login
ppl-ai/modelcontextprotocol

Ein Modellkontextprotokoll-Server-Konnektor für die Perplexity API, der Websuchfunktionen ermöglicht, ohne das MCP-Ökosystem zu verlassen.

MITJavaScript 1.2kppl-ai Last Updated: 2025-04-27
https://github.com/ppl-ai/modelcontextprotocol

Model Context Protocol - Perplexity API Konnektor

Projektübersicht

Model Context Protocol (MCP) ist ein innovatives Server-Implementierungsprojekt, das speziell für die Integration der Sonar API von Perplexity entwickelt wurde. Das Hauptziel dieses Projekts ist es, KI-Assistenten wie Claude eine beispiellose Echtzeit-Websuchfunktion zu bieten, die es Benutzern ermöglicht, die neuesten Web-Informationen zu erhalten, ohne das MCP-Ökosystem zu verlassen.

Projektadresse: https://github.com/ppl-ai/modelcontextprotocol

Lizenz: MIT License

Kernfunktionen und -merkmale

🌐 Echtzeit-Websuche

  • Sonar API Integration: Direkte Integration der leistungsstarken Suchmaschine von Perplexity
  • Echtzeit-Informationsbeschaffung: Bereitstellung der aktuellsten und genauesten Web-Informationen
  • Nahtlose Erfahrung: Durchführung aller Suchvorgänge innerhalb des MCP-Ökosystems

🛠️ Entwicklerfreundlich

  • Verschiedene Bereitstellungsmethoden: Unterstützung für Docker-Container-Bereitstellung und direkte NPM-Installation
  • TypeScript-Unterstützung: Entwicklung mit TypeScript für bessere Typsicherheit
  • Flexible Konfiguration: Anpassbare Suchparameter und API-Aufrufeinstellungen

🔧 Tools und Schnittstellen

perplexity_ask Tool

Dieses Tool ist die Kernfunktion des Projekts und bietet folgende Möglichkeiten:

Funktionsbeschreibung: Dialogbasierte Interaktion mit der Sonar API zur Realisierung der Echtzeit-Websuche

Eingabeparameter:

  • messages (Array): Array von Dialognachrichten
    • role (String): Nachrichtenrolle (z. B. system, user, assistant)
    • content (String): Nachrichteninhalte

🖥️ Unterstützte Plattformen

Claude Desktop

  • Native Integration: Perfekte Unterstützung für die Claude Desktop-Anwendung
  • Einfache Konfiguration: Aktivierung über JSON-Konfigurationsdatei
  • Tool-Visualisierung: Anzeige eines Hammersymbols in der Benutzeroberfläche, um anzuzeigen, dass das Tool aktiviert ist

Cursor IDE

  • Entwicklungsumgebungsintegration: Unterstützung für den Cursor-Codeeditor
  • Globaler MCP-Server: Konfigurierbar als global verfügbares Tool
  • Entwickler-Workflow: Nahtlose Integration in den täglichen Workflow von Entwicklern

Schnellstart

Umgebungsvorbereitung

  1. API-Schlüssel abrufen

    • Registrieren Sie ein Sonar API-Konto
    • Generieren Sie einen API-Schlüssel über das Entwickler-Dashboard
    • Setzen Sie die Umgebungsvariable PERPLEXITY_API_KEY
  2. Projekt installieren

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

Bereitstellungsoptionen

Option 1: Docker-Bereitstellung

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

Option 2: Direkte NPM-Ausführung

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

Technische Architektur

Systemkomponenten

  • MCP-Server: Kernservicekomponente, die die Protokollkommunikation verarbeitet
  • Sonar API-Client: Schnittstellenschicht zur Perplexity API
  • Nachrichtenprozessor: Verarbeitung von Dialognachrichten und Suchanfragen
  • Konfigurationsmanagement: Flexibles Parameterkonfigurationssystem

Datenfluss

  1. Anfrageempfang: Claude oder andere Clients senden eine Suchanfrage
  2. Nachrichtenverarbeitung: Der MCP-Server analysiert die Dialognachrichten
  3. API-Aufruf: Senden einer Suchanfrage an die Sonar API
  4. Ergebnisrückgabe: Echtzeit-Suchergebnisse werden an den Client zurückgegeben

Anwendungsfälle

📚 Forschung und Lernen

  • Echtzeit-Informationsabfrage: Abrufen der neuesten Nachrichten und technischen Entwicklungen
  • Akademische Forschung: Schnelles Auffinden relevanter Literatur und Materialien
  • Faktenprüfung: Überprüfung der Genauigkeit und Aktualität von Informationen

💼 Geschäftsanwendungen

  • Marktanalyse: Abrufen der neuesten Markttrends und Wettbewerbsinformationen
  • Kundenservice: Bereitstellung der neuesten Produktinformationen und Lösungen für Kunden
  • Content-Erstellung: Abrufen der neuesten Informationen für die Content-Erstellung

🛠️ Entwickler-Tools

  • Technische Dokumentationsabfrage: Schnelles Auffinden der neuesten technischen Dokumentation und API-Informationen
  • Problemlösung: Auffinden der neuesten Lösungen und Best Practices
  • Trendverfolgung: Verfolgen von technischen Entwicklungstrends und neuen Technologien

Anpassung und Erweiterung

Suchparameterkonfiguration

Das Projekt ermöglicht es Entwicklern, Suchparameter direkt in der Datei index.ts zu ändern, einschließlich:

  • Einstellung des Suchmodus
  • Begrenzung der Anzahl der Ergebnisse
  • Spracheinstellungen
  • Zeitbereichsfilterung

Projektvorteile

✅ Open Source und transparent

  • MIT-Lizenz: Vollständig Open Source, frei verwendbar, modifizierbar und verteilbar
  • Community-getrieben: Beitragende sind herzlich eingeladen, an der Projektentwicklung teilzunehmen

✅ Einfache Integration

  • Standardisiertes Protokoll: Basierend auf dem MCP-Standard, hohe Kompatibilität
  • Multi-Plattform-Unterstützung: Unterstützung für verschiedene KI-Assistenten und Entwicklungsumgebungen

✅ Hochgradig anpassbar

  • Flexible Konfiguration: Unterstützung für verschiedene benutzerdefinierte Suchparameter
  • Hohe Erweiterbarkeit: Funktionen können je nach Bedarf erweitert werden

Zusammenfassung

Model Context Protocol - Perplexity API Konnektor ist ein leistungsstarkes und einfach zu bedienendes Open-Source-Projekt, das KI-Assistenten leistungsstarke Echtzeit-Websuchfunktionen bietet. Durch die Integration der Sonar API von Perplexity ermöglicht dieses Projekt Benutzern, die neuesten und genauesten Web-Informationen zu erhalten, ohne ihre aktuelle Arbeitsumgebung zu verlassen.

Ob Forschung und Lernen, Geschäftsanwendungen oder Entwicklungsarbeit, dieses Projekt kann die Nützlichkeit und Genauigkeit von KI-Assistenten erheblich verbessern. Seine Open-Source-Natur und flexiblen Konfigurationsoptionen machen es zu einer idealen Wahl für Entwickler und Unternehmen.

Geeignet für:

  • KI-Anwendungsentwickler
  • Forscher und Wissenschaftler
  • Content-Ersteller
  • Unternehmensbenutzer, die Echtzeitinformationen benötigen

Kernwert:

  • Verbesserung der Informationsbeschaffungsfähigkeiten von KI-Assistenten
  • Vereinfachung des Integrationsprozesses der Echtzeitsuche
  • Bereitstellung einer zuverlässigen und genauen Web-Informationsquelle