Servidor MCP de Pipedream

Esta es una implementación de referencia del servidor MCP de Pipedream. Puedes ejecutar tu propio servidor MCP para más de 2500 aplicaciones y API, y funciona con Pipedream Connect .

Puede:

• Ejecute los servidores localmente con npx @pipedream/mcp

• Hospede usted mismo los servidores para usarlos dentro de su aplicación o empresa

Vea el servidor en acción en mcp.pipedream.com y chat.pipedream.com

Publicamos este código como referencia para que puedas comprender mejor cómo usar Pipedream Connect en esta aplicación. Aún está en desarrollo y no está completamente documentado. Si tienes alguna pregunta, contáctanos.

⭐ Características

• Ejecute su propio servidor MCP para más de 2500 aplicaciones y API

• Administra servidores para tus usuarios desde tu propia aplicación.

• Conectar cuentas, configurar parámetros y realizar solicitudes API, todo a través de herramientas

• Almacenamiento de credenciales y OAuth totalmente administrado ( consulte la documentación de seguridad )

Related MCP server: Integrations MCP

🚀 Primeros pasos

Los servidores MCP de Pipedream utilizan la API de Pipedream Connect para gestionar la autenticación y realizar solicitudes a la API. Para ejecutar un servidor MCP, necesitará un proyecto de Pipedream y las credenciales de la API de Pipedream.

1. Regístrate en Pipedream

2. Crea un proyecto . Todas las cuentas conectadas mediante MCP se almacenarán aquí.

3. Crear un cliente OAuth de Pipedream

4. Establezca las variables de entorno (consulte .env.example ) (directamente en su sesión de shell, archivos de puntos, etc.):

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

Conceptos de Pipedream para entender

Si utiliza servidores MCP para su aplicación, probablemente le convenga usar la interfaz SSE . El servidor SSE acepta dos parámetros de ruta:

1. external_user_id — Este es el ID de su usuario en su sistema, el que utiliza para identificarlo de forma única. Cualquier solicitud realizada a esa ruta se asocia a ese usuario final y utilizará la autenticación que Pipedream almacena para ese usuario. Consulte la documentación para obtener más información.

2. app — El "slug del nombre" de la app (el identificador único de la app), que se encuentra en la sección de Autenticación de cualquier app de Pipedream . Por ejemplo, el slug de la app para Slack es slack .

Si el usuario 123 desea conectarse al servidor MCP slack , el cliente MCP realizará una solicitud a la ruta /123/slack . Consulte la documentación de SSE a continuación para obtener más información.

Descripción general del servidor

Hay dos formas de utilizar este servidor MCP.

1 - Específico de la aplicación /{external_user_id}/{app} Actualmente está disponible en mcp.pipedream.com . Puedes usar un punto de conexión para cada aplicación. Todas las herramientas disponibles para esa aplicación estarán disponibles en ese punto de conexión.

2 - Dinámico /{external_user_id} Esta es una versión experimental, ya que depende de que las herramientas se actualicen dinámicamente. Usamos este servidor para alimentar las herramientas en chat.pipedream.com .

[!NOTA] El código para el servidor MCP dinámico está disponible en este repositorio, pero aún no podrá ejecutarlo localmente ya que depende de una base de datos interna.

Por favor, háganos saber si desea ejecutar esto usted mismo.

Hospedaje de su propio servidor

Usando el Dockerfile

Si tiene Docker instalado localmente, puede compilar y ejecutar el contenedor:

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

Esto expone un servidor MCP genérico en http://localhost:3010/:external_user_id/:app .

Desarrollo

cp .env.example .env y complete los detalles de su proyecto de desarrollo.

pnpm install

Inicie el servidor con el transporte HTTP Streamable

pnpm dev:http

Puede utilizar la variable de entorno opcional PD_SDK_DEBUG para imprimir todas las solicitudes y respuestas que van a la API de conexión.

PD_SDK_DEBUG=true pnpm dev:http

Luego ejecute el inspector:

npx @modelcontextprotocol/inspector

Utilice http://localhost:3010/v1/{external_user_id}/{app} para el transporte HTTP transmisible o http://localhost:3010/{external_user_id}/{app} para el transporte SSE.

Estas URL también pueden ser utilizadas por otros clientes (por ejemplo, Cursor).

Configuración de transporte de Stdio

Stdio solo se ha probado con MCP Inspector.

npx @modelcontextprotocol/inspector bun src/stdio.ts

Consulte los registros de la URL del inspector.

Asegúrese de que el lado izquierdo del inspector coincida con esto:

Luego presione “Lista de herramientas” para obtener la lista de herramientas MCP.

Licencia

Versión de licencia disponible de Pipedream Source 1.0: consulte https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE