Dify Connect MCP: Nahtlose Integration von MCP (Model Context Protocol) für Dify Workflows

Allgemeine Einführung

Dify Verbinden Sie MCP ist ein Open-Source-Projekt, das auf GitHub gehostet wird und darauf abzielt, Nutzern der Dify-Plattform ein bequemes Tool zur nahtlosen Verbindung mit Dify-Workflows über das Model Context Protocol (MCP) zur Verfügung zu stellen. Das vom difybase-Team entwickelte Projekt konzentriert sich auf die Verbesserung der Entwicklungseffizienz von KI-Anwendungen und ist besonders für Entwickler geeignet, die komplexe Workflows integrieren müssen. Es bietet eine effiziente Schnittstelle zwischen externen Diensten und den Kernfunktionen von Dify (z.B. Modellaufrufe, Zugriff auf die Wissensdatenbank, etc.) durch standardisierte Protokollunterstützung. Sowohl individuelle Entwickler als auch Unternehmensanwender können mit diesem Tool schnell kundenspezifische Funktionserweiterungen implementieren und den Entwicklungsprozess vereinfachen. Derzeit befindet sich das Projekt noch in der Entwicklungsphase, die Community ist sehr aktiv, Entwickler sind herzlich eingeladen, Code beizusteuern oder Vorschläge zu machen.

Funktionsliste

• Servereinrichtung mit MCP-ProtokollunterstützungModel Context Protocol: Bietet ein Server-Framework für die Verbindung von Dify-Workflows auf der Grundlage des Model Context Protocol.
• Dify API-IntegrationErmöglicht die direkte Kommunikation mit der Dify-Plattform, indem der API-Schlüssel und die Basis-URL von Dify konfiguriert werden.
• Unterstützung von Multi-WorkflowsErmöglicht es, mehrere Dify-Workflows zu verwalten und mit unterschiedlichen Schlüsseln aufzurufen.
• Standardisierter Kontext LieferungNutzung des MCP-Protokolls, um einen reibungslosen Datenaustausch zwischen externen Diensten und Dify zu gewährleisten.
• Open-Source-ZusammenarbeitDer Projektcode ist vollständig quelloffen, die Nutzer können die Funktion nach ihren Bedürfnissen verändern oder erweitern.
• Unterstützung bei der FehlersucheKompatibilität mit Tools wie MCP Inspector für Entwickler zum Debuggen und Optimieren.

Hilfe verwenden

Einbauverfahren

Dify Connect MCP ist ein Open-Source-Projekt, das auf GitHub basiert und für dessen Installation und Nutzung einige technische Grundlagen erforderlich sind. Hier sind die detaillierten Installationsschritte:

1. Vorbereitung der Umwelt
   • Stellen Sie sicher, dass Sie Node.js (empfohlene Version 16 oder höher) und Git auf Ihrem Computer installiert haben.
   • Zum Debuggen wird empfohlen, MCP Inspector zu installieren. Die Installationsmethode können Sie der offiziellen Dokumentation entnehmen.
   • Richten Sie ein Dify-Konto ein und holen Sie sich den API-Schlüssel (Dify API Key) und die Basis-URL (normalerweise die https://cloud.dify.ai/v1(dies kann je nach Einsatz variieren).
2. Projektcode klonen
   Öffnen Sie ein Terminal und geben Sie den folgenden Befehl ein, um das Projekt lokal zu klonen:

git clone https://github.com/difybase/dify-connect-mcp.git

Sobald das Klonen abgeschlossen ist, wechseln Sie in das Projektverzeichnis:

cd dify-connect-mcp

3. Installation von Abhängigkeiten
   Das Projekt basiert auf der TypeScript-Entwicklung, daher müssen Sie die entsprechenden Abhängigkeiten installieren. Führen Sie den folgenden Befehl aus:

npm install

Dadurch werden automatisch alle npm-Pakete heruntergeladen, die für das Projekt benötigt werden.

4. Umgebungsvariablen konfigurieren
   Erstellen Sie im Stammverzeichnis des Projekts eine config.yaml Datei, in der die Konfigurationsinformationen von Dify gespeichert werden. Eine Beispielkonfiguration ist unten abgebildet:

dify_base_url: "https://cloud.dify.ai/v1"
dify_app_sks:
- "app-sk1"
- "app-sk2"

• dify_base_urlAPI-Adresse für die Dify-Plattform.
• dify_app_sksDify: Eine Liste von Schlüsseln für die Dify-Anwendung, die jeweils einem Workflow entsprechen.

5. Erstellen und ausführen
   Nachdem Sie die Konfiguration abgeschlossen haben, verwenden Sie den folgenden Befehl, um das Projekt zu erstellen:

   npm run build
   

   Sobald der Build abgeschlossen ist, starten Sie den Server:

   npm start
   

   Wenn Sie ein Protokoll wie "Server running" sehen, wurde der Server erfolgreich gestartet.

Wie zu verwenden

Nach der Installation läuft Dify Connect MCP als MCP-Server und kann über die Standardein- und -ausgabe (stdio) mit den Clients kommunizieren. Nachfolgend finden Sie Einzelheiten zur Verwendung des Programms:

Konfigurieren des Clients

Um eine Anwendung auf der Client-Seite zu erstellen (z. B. die Claude Desktop oder andere MCP-fähige Tools verwenden, müssen Sie der Client-Konfigurationsdatei MCP-Serverinformationen hinzufügen. Eine Beispielkonfiguration ist unten abgebildet:

{
"mcpServers": {
"dify-connect-mcp": {
"command": "node",
"args": ["<你的项目路径>/build/index.js"],
"env": {
"DIFY_API_KEY": "your-api-key"
}
}
}
}

• <你的项目路径>: Ersetzen durch dify-connect-mcp Der tatsächliche Pfad der
• DIFY_API_KEYErsetzen Sie durch den API-Schlüssel, den Sie von der Dify-Plattform erhalten haben.

Nach dem Speichern der Konfigurationsdatei und dem Neustart des Clients stellt der MCP-Server automatisch eine Verbindung mit der Dify-Plattform her.

Aufrufen von Dify-Workflows

Angenommen, Sie haben einen Workflow in der Dify Plattform erstellt (z.B. einen Textanalyse-Workflow mit dem Namen "text-analyzer"), dann können Sie ihn mit den folgenden Schritten aufrufen:

1. sicher config.yaml Der Schlüssel für den entsprechenden Workflow wurde in der
2. Geben Sie auf einem MCP-fähigen Client einen Befehl ähnlich dem folgenden ein:

   运行 text-analyzer 工作流，输入文本为“这是测试消息”
   

3. Der MCP-Server sendet die Anfrage an Dify, führt den Workflow aus und liefert die Ergebnisse zurück.

Fehlersuche und Optimierung

Wenn Probleme auftreten, können Sie den MCP Inspector zur Fehlersuche verwenden:

• Starten Sie den MCP Inspector (Einzelheiten finden Sie in der Dokumentation).
• Führen Sie den folgenden Befehl im Terminal aus, um den Debug-Modus zu aktivieren:

  npm run start:debug
  

• Der Inspector zeigt Kommunikationsprotokolle an, um Ihnen bei der Suche nach Problemen zu helfen.

Hauptfunktionen

1. die Integration der Dify API

• Verfahren:: Leitartikel config.yamlWenn Sie Dify verwenden möchten, geben Sie die Basis-URL und den API-Schlüssel von Dify ein.
• funktionale RolleErmöglicht Konnektivität zu Dify Cloud- oder selbst gehosteten Instanzen und unterstützt Aufrufe von Modellen, Wissensdatenbanken und anderen Ressourcen.
• caveatVergewissern Sie sich, dass der Schlüssel gültig ist und mit dem Ziel-Workflow übereinstimmt, andernfalls wird ein Authentifizierungsfehler zurückgegeben.

2. die Verwaltung mehrerer Arbeitsabläufe

• Verfahren: in dify_app_sks Der Liste werden mehrere Schlüssel hinzugefügt, die jeweils einem Arbeitsablauf entsprechen.
• funktionale RolleErmöglicht die gleichzeitige Ausführung mehrerer unabhängiger Arbeitsabläufe, z. B. Texterstellung, Datenanalyse usw.
• AnwendungsbeispielKonfigurieren Sie zwei Tasten, um den "Übersetzungs-Workflow" bzw. den "Zusammenfassungs-Workflow" aufzurufen, und geben Sie denselben Text ein, um die Übersetzungs- und Zusammenfassungsergebnisse gleichzeitig zu erhalten.

3. benutzerdefinierte Erweiterungen

• Verfahren::
  1. Ändern Sie den Quellcode des Projekts (z. B. src/index.ts), die neue Funktionen hinzufügen.
  2. Wiederherstellen und ausführen:npm run build && npm start.
• funktionale RolleUm spezifische Anforderungen zu erfüllen, wie z. B. das Hinzufügen von Protokollierung oder benutzerdefinierter Datenverarbeitungslogik.
• caveatEs wird empfohlen, das Projekt zunächst zu forken und lokal zu testen, um direkte Änderungen am Master-Zweig zu vermeiden.

caveat

• SicherheitEs wird empfohlen, den API-Schlüssel nicht an andere weiterzugeben. config.yaml Mitglied werden .gitignore.
• KompatibilitätVergewissern Sie sich, dass der Client das MCP-Protokoll unterstützt, sonst kann er nicht kommunizieren.
• Unterstützung der GemeinschaftWenn Sie auf Probleme stoßen, senden Sie Ihr Feedback auf der GitHub Issues-Seite und die Community-Entwickler werden Ihnen helfen.

Mit den oben genannten Schritten können Sie schnell mit Dify Connect MCP loslegen, Dify-Workflows in Ihre eigenen Projekte integrieren und eine effiziente KI-Entwicklung genießen!