Servidor MCP de Pipedream

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

Puede:

• Ejecute los servidores localmente con npx @pipedream/mcp
• Hospede usted mismo los servidores para usarlos dentro de su aplicación o empresa

⭐ Características

• Ejecute su propio servidor MCP para más de 2500 aplicaciones
• 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 )

🚀 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 siguientes variables de entorno utilizando su método preferido (directamente en su sesión de shell, archivos de puntos, etc.)

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.

Ejecutar el servidor localmente para desarrollo

sse

estudio

Opcionalmente, puede agregar la variable de entorno PD_SDK_DEBUG=true a los comandos anteriores para volcar solicitudes y respuestas a la API de Pipecream Connect.

sse

estudio

Ejecutando el servidor a través de npx

Los servidores MCP de Pipedream proporcionan dos interfaces a las que los clientes pueden conectarse:

1. Stdio : Utiliza entrada/salida estándar. Ideal para conectar cuentas y realizar solicitudes MCP desde editores y otros clientes MCP locales. Ideal para pruebas.
2. SSE : Utiliza eventos enviados por el servidor para comunicarse con los clientes. Úselo cuando desee alojar un servidor MCP con conexión a internet que otros servicios o sus clientes puedan usar.

Estudio

Primero, configure estas variables en su entorno .

Ejecute el servidor stdio para una aplicación específica, pasando el slug del nombre de la aplicación a la opción --app :

También puede especificar un ID de usuario externo opcional: cualquier ID que utilice para identificar a su usuario en su aplicación (de lo contrario, se generará un UUID aleatorio):

SSE

Primero, configure estas variables en su entorno .

Ejecute el servidor SSE:

Esto expone un servidor MCP genérico que le permite conectarse a cualquiera de nuestras más de 2500 aplicaciones pasando el slug del nombre de la aplicación directamente en la ruta :

Para conectarse al servidor:

1. Conéctese a http://localhost:3010/:external_user_id/:app donde:
   • :external_user_id es un identificador único para la sesión
   • :app es la aplicación de Pipedream que se debe utilizar (por ejemplo, "slack")
2. El servidor establecerá una conexión SSE y registrará herramientas para la aplicación especificada.
3. Para enviar mensajes, publíquelos en http://localhost:3010/:external_user_id/:app/messages?sessionId=<sessionId> donde:
   • <sessionId> se proporciona en la respuesta de la conexión inicial

También puede especificar una aplicación y un puerto a través de CLI:

Hospedaje de su propio servidor

Usando el Dockerfile

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

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

Paso a paso

El servidor SSE se ejecuta como una aplicación Node.js Express. La implementación es sencilla y sirve como referencia. Debe agregar la autorización y personalizar la aplicación según sus necesidades .

Clonar el repositorio e instalar las dependencias:

Establezca estas variables en su entorno utilizando el almacén de env/secrets que utilice en su infraestructura. Para probarlo localmente, copie el archivo .env.example :

y rellena los valores:

Ejecutar la compilación:

Y ejecuta el servidor SSE:

Autorización

MCP ha añadido recientemente compatibilidad con servidores que autorizan solicitudes mediante OAuth . Si aloja su propio servidor, debería implementar la compatibilidad con OAuth para proteger el acceso a los datos de sus clientes.

Depuración

Primero, configure estas variables en su entorno .

Utilice el Inspector MCP o su cliente MCP preferido para conectarse al servidor:

Abra http://localhost:5173/ y configure el tipo de transporte en STDIO .

Personalización

Puedes personalizar esta implementación de cualquier forma que desees, por ejemplo:

1. Modificar config.ts para cambiar la configuración predeterminada
2. Ampliar registerComponentTools.ts para agregar herramientas adicionales o limitar las herramientas a un conjunto fijo.
3. Mejorar la implementación para aprovechar la última versión de la especificación MCP.
4. Persistir datos de sesión en Redis, o cualquier almacén de datos que utilice.

Licencia

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