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

🚀 Einladung zum Erleben: Chinas erste KI-IDE Intelligente Programmiersoftware Trae Chinesische Version downloadDer DeepSeek-R1 und Doubao-pro sind unbegrenzt verfügbar!

Allgemeine Einführung

Dify Verbinden Sie MCP ist ein Open-Source-Projekt, das auf GitHub gehostet wird und darauf abzielt, den Nutzern der Dify-Plattform ein bequemes Tool zur Verfügung zu stellen, das eine nahtlose Verbindung mit Dify-Workflows über das Model Context Protocol (MCP) ermöglicht. 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 Wissensbasis usw.) durch standardisierte Protokollunterstützung. Sowohl einzelne 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 Code des Projekts ist vollständig quelloffen, die Benutzer können die Funktion nach Belieben verändern oder erweitern.
Unterstützung bei der FehlersucheKompatibilität mit Tools wie MCP Inspector für Entwickler zum Debuggen und Optimieren.

Hilfe verwenden

Ablauf der Installation

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:

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. Sie können die Installationsmethode in der offiziellen Dokumentation nachlesen.
- 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).
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

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-Installation

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

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.

Erstellen und ausführen
Nachdem Sie die Konfiguration abgeschlossen haben, erstellen Sie das Projekt mit dem folgenden Befehl:
```
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:

{
"mcpServer": {
"dify-connect-mcp": {
"Befehl": "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:

sicher config.yaml Der Schlüssel für den entsprechenden Workflow wurde in der

Geben Sie auf einem MCP-fähigen Client einen Befehl ähnlich dem folgenden ein:

Starten Sie den Text-Analyse-Workflow und geben Sie den Text "Dies ist eine Testnachricht" ein.

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!