Pipedream MCP-Server

Dies ist eine Referenzimplementierung des Pipedream MCP-Servers. Sie können Ihren eigenen MCP-Server für über 2.500 Apps und APIs betreiben. Unterstützt wird er von Pipedream Connect .

Du kannst:

• Führen Sie die Server lokal mit npx @pipedream/mcp aus

• Hosten Sie die Server selbst , um sie innerhalb Ihrer App oder Ihres Unternehmens zu verwenden

Sehen Sie den Server in Aktion unter mcp.pipedream.com und chat.pipedream.com

Wir haben diesen Code als Referenz veröffentlicht, damit Sie die Verwendung von Pipedream Connect für eine solche Anwendung besser verstehen. Dies ist noch in Arbeit und nicht vollständig dokumentiert. Bei Fragen wenden Sie sich bitte an uns.

⭐ Funktionen

• Betreiben Sie Ihren eigenen MCP-Server für über 2.500 Apps und APIs

• Verwalten Sie Server für Ihre Benutzer in Ihrer eigenen App.

• Konten verbinden, Parameter konfigurieren und API-Anfragen stellen – alles über Tools

• Vollständig verwalteter OAuth- und Anmeldeinformationsspeicher ( siehe Sicherheitsdokumente )

Related MCP server: Integrations MCP

🚀 Erste Schritte

Die MCP-Server von Pipedream nutzen die Pipedream Connect API zur Authentifizierung und für API-Anfragen. Zum Betrieb eines MCP-Servers benötigen Sie ein Pipedream-Projekt und Pipedream-API-Anmeldeinformationen.

1. Melden Sie sich bei Pipedream an

2. Erstellen Sie ein Projekt . Alle über MCP verbundenen Konten werden hier gespeichert.

3. Erstellen Sie einen Pipedream OAuth-Client

4. Legen Sie die Umgebungsvariablen fest (siehe .env.example ) (direkt in Ihrer Shell-Sitzung, in Dot-Dateien usw.):

PIPEDREAM_CLIENT_ID=your_client_id
PIPEDREAM_CLIENT_SECRET=your_client_secret
PIPEDREAM_PROJECT_ID=your_project_id
PIPEDREAM_PROJECT_ENVIRONMENT=development

Pipedream-Konzepte zum Verstehen

Wenn Sie MCP-Server für Ihre App betreiben, möchten Sie wahrscheinlich die SSE-Schnittstelle verwenden. Der SSE-Server akzeptiert zwei Routenparameter:

1. external_user_id — Dies ist die ID Ihres Benutzers in Ihrem System – die ID, die Sie zur eindeutigen Identifizierung verwenden. Alle Anfragen an diese Route sind an diesen Endbenutzer gekoppelt und verwenden die Authentifizierungsdaten, die Pipedream für diesen Benutzer speichert. Weitere Informationen finden Sie in der Dokumentation .

2. app – Der „Namens-Slug“ der App (die eindeutige Kennung für die App), der im Abschnitt „Authentifizierung“ jeder Pipedream-App zu finden ist. Der App-Slug für Slack lautet beispielsweise slack .

Wenn Ihr Benutzer 123 eine Verbindung zum slack -MCP-Server herstellen möchte, sendet Ihr MCP-Client eine Anfrage an die Route /123/slack . Weitere Informationen finden Sie in der SSE-Dokumentation weiter unten .

Serverübersicht

Es gibt zwei Möglichkeiten, diesen MCP-Server zu verwenden.

1 – App-spezifisch /{external_user_id}/{app} Dies ist derzeit unter mcp.pipedream.com verfügbar. Sie können für jede App einen Endpunkt verwenden. Alle für diese App verfügbaren Tools sind dort verfügbar.

2 - Dynamisch /{external_user_id} Dies ist eine experimentelle Version, da sie auf dynamischen Updates basiert. Wir nutzen diesen Server für die Tools auf chat.pipedream.com .

[!NOTE] Der Code für den dynamischen MCP-Server ist in diesem Repository verfügbar, Sie können ihn jedoch noch nicht lokal ausführen, da er auf einer internen Datenbank basiert.

Bitte lassen Sie uns wissen, ob Sie dies selbst ausführen möchten.

Hosten Ihres eigenen Servers

Verwenden der Dockerfile

Wenn Sie Docker lokal installiert haben, können Sie den Container erstellen und ausführen:

> docker build -t pipedream-connect .
> docker run -d --name pd-mcp -p 3010:3010 --env-file .env pipedream-connect:latest

Dadurch wird ein generischer MCP-Server unter http://localhost:3010/:external_user_id/:app bereitgestellt.

Entwicklung

cp .env.example .env und geben Sie die Details Ihres Entwicklungsprojekts ein.

pnpm install

Starten Sie den Server mit Streamable HTTP Transport

pnpm dev:http

Sie können die optionale Umgebungsvariable PD_SDK_DEBUG verwenden, um alle Anfragen und Antworten an die Connect-API auszudrucken.

PD_SDK_DEBUG=true pnpm dev:http

Führen Sie dann den Inspektor aus:

npx @modelcontextprotocol/inspector

Verwenden Sie http://localhost:3010/v1/{external_user_id}/{app} für streambaren HTTP-Transport oder http://localhost:3010/{external_user_id}/{app} für SSE-Transport.

Diese URLs können auch von anderen Clients (z. B. Cursor) verwendet werden.

Stdio-Transport-Setup

Stdio wurde nur mit dem MCP Inspector getestet.

npx @modelcontextprotocol/inspector bun src/stdio.ts

Die URL des Inspektors finden Sie in den Protokollen.

Stellen Sie sicher, dass die linke Seite des Inspektors mit Folgendem übereinstimmt:

Drücken Sie dann „Tools auflisten“, um die Liste der MCP-Tools abzurufen.

Lizenz

Pipedream-Quelle Verfügbare Lizenzversion 1.0 – Siehe https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE