Dify Connect MCP: Integración perfecta de MCP (Model Context Protocol) para los flujos de trabajo de Dify.

Introducción general

Dify Conectar MCP es un proyecto de código abierto alojado en GitHub que tiene como objetivo proporcionar a los usuarios de la plataforma Dify una herramienta conveniente para conectarse sin problemas con los flujos de trabajo de Dify a través del Protocolo de Contexto de Modelo (MCP). Desarrollado por el equipo de difybase, el proyecto se centra en mejorar la eficiencia del desarrollo de aplicaciones de IA, y es especialmente adecuado para los desarrolladores que necesitan integrar flujos de trabajo complejos. Interconecta eficazmente servicios externos con las funciones básicas de Dify (por ejemplo, invocación de modelos, acceso a la base de conocimientos, etc.) mediante el soporte de protocolos estandarizados. Tanto los desarrolladores individuales como los usuarios empresariales pueden implementar rápidamente extensiones funcionales personalizadas y simplificar el proceso de desarrollo a través de esta herramienta. Actualmente, el proyecto está aún en fase de desarrollo, la comunidad es muy activa, los desarrolladores son bienvenidos a participar aportando código o haciendo sugerencias.

Lista de funciones

• Configuración del servidor compatible con el protocolo MCP: Proporciona un marco de servidor para conectar flujos de trabajo de Dify basados en el Protocolo de Contexto de Modelo.
• Integración de la API de DifyPermite la comunicación directa con la plataforma de Dify configurando la clave API y la URL base de Dify.
• Compatibilidad con varios flujos de trabajoPermite gestionar múltiples flujos de trabajo de Dify e invocarlos con diferentes claves.
• Contexto normalizadoUtilización del protocolo MCP para garantizar una interacción fluida de datos entre los servicios externos y Dify.
• Colaboración de código abiertoEl código del proyecto es totalmente de código abierto, por lo que los usuarios pueden modificarlo o ampliarlo para adaptarlo a sus necesidades específicas.
• Soporte de depuración: Proporciona compatibilidad con herramientas como MCP Inspector para que los desarrolladores puedan depurar y optimizar.

Utilizar la ayuda

Proceso de instalación

Dify Connect MCP es un proyecto de código abierto basado en GitHub, que requiere algunos fundamentos técnicos para instalar y utilizar. A continuación se detallan los pasos de instalación:

1. Preparación medioambiental
   • Asegúrate de que tienes Node.js (se recomienda la versión 16 o superior) y Git instalados en tu ordenador.
   • Si necesita depurar, se recomienda instalar MCP Inspector, puede obtener el método de instalación a través de la documentación oficial.
   • Prepare una cuenta de Dify y obtenga la clave API (Dify API Key) y la URL base (normalmente la https://cloud.dify.ai/v1(que puede variar en función de su despliegue).
2. Clonación del código del proyecto
   Abra un terminal e introduzca el siguiente comando para clonar el proyecto localmente:

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

Una vez finalizada la clonación, vaya al directorio del proyecto:

cd dify-connect-mcp

3. Instalación de dependencias
   El proyecto se basa en el desarrollo de TypeScript, por lo que es necesario instalar las dependencias pertinentes. Ejecute el siguiente comando:

npm install

Esto descargará automáticamente todos los paquetes npm necesarios para el proyecto.

4. Configuración de variables de entorno
   En el directorio raíz del proyecto, cree un directorio config.yaml utilizado para almacenar la información de configuración de Dify. A continuación se muestra un ejemplo de configuración:

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

• dify_base_urlDirección API de la plataforma Dify.
• dify_app_sks: Una lista de claves para la aplicación Dify, cada una correspondiente a un flujo de trabajo.

5. Construir y ejecutar
   Después de completar la configuración, construya el proyecto utilizando el siguiente comando:

   npm run build
   

   Una vez finalizada la compilación, ejecute el servidor:

   npm start
   

   Si ve un registro como "Servidor en ejecución", el servidor se ha iniciado correctamente.

Cómo utilizarlo

Una vez instalado, Dify Connect MCP se ejecuta como un servidor MCP y puede comunicarse con los clientes a través de la entrada y salida estándar (stdio). A continuación se detalla cómo utilizarlo:

Configurar el cliente

Para crear una aplicación en el lado del cliente (por ejemplo, la aplicación Claude Desktop u otras herramientas habilitadas para MCP, deberá añadir la información del servidor MCP al archivo de configuración del cliente. A continuación se muestra un ejemplo de configuración:

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

• <你的项目路径>: Sustituir por dify-connect-mcp La ruta real del
• DIFY_API_KEY: Reemplace con la clave API que obtuvo de la plataforma Dify.

Después de guardar el archivo de configuración y reiniciar el cliente, el servidor MCP establecerá automáticamente una conexión con la plataforma Dify.

Invocación de flujos de trabajo de Dify

Suponiendo que haya creado un flujo de trabajo en la plataforma Dify (por ejemplo, un flujo de trabajo de análisis de texto llamado "text-analyzer"), puede invocarlo siguiendo estos pasos:

1. seguro config.yaml La clave para el flujo de trabajo correspondiente se ha añadido en el archivo
2. En un cliente habilitado para MCP, introduzca un comando similar al siguiente:

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

3. El servidor MCP envía la solicitud a Dify, ejecuta el flujo de trabajo y devuelve los resultados.

Depuración y optimización

Si encuentra problemas, puede utilizar el Inspector MCP para depurar:

• Inicie el Inspector MCP (consulte su documentación para más detalles).
• Ejecute el siguiente comando en el terminal para activar el modo de depuración:

  npm run start:debug
  

• El Inspector muestra registros de comunicación para ayudarle a localizar problemas.

Funciones principales

1. Integración de la API de Dify

• procedimiento:: Editorial config.yamlSi desea utilizar Dify, introduzca la URL base y la clave API de Dify.
• papel funcionalPermite la conectividad a la nube de Dify o a instancias autoalojadas, soportando llamadas a modelos, bases de conocimiento y otros recursos.
• advertencia: Asegúrese de que la clave es válida y coincide con el flujo de trabajo de destino, de lo contrario se devuelve un error de autenticación.

2. Gestión de flujos de trabajo múltiples

• procedimiento: en dify_app_sks Se añaden varias claves a la lista, cada una correspondiente a un flujo de trabajo.
• papel funcionalPermite ejecutar simultáneamente varios flujos de trabajo independientes, como la generación de textos, el análisis de datos, etc.
• ejemplo de usoConfigure dos teclas para invocar el "flujo de trabajo de traducción" y el "flujo de trabajo de resumen" respectivamente, e introduzca el mismo texto para obtener los resultados de traducción y resumen al mismo tiempo.

3. Extensiones personalizadas

• procedimiento::
  1. Modificar el código fuente del proyecto (por ejemplo src/index.ts), añadiendo nuevas funciones.
  2. Reconstruir y ejecutar:npm run build && npm start.
• papel funcionalPara satisfacer necesidades específicas, como añadir lógica de registro o procesamiento de datos personalizados.
• advertenciaSe recomienda bifurcar primero el proyecto y probarlo localmente para evitar modificar directamente la rama maestra.

advertencia

• seguridad: No revele la clave API a terceros, se recomienda que el config.yaml Hágase socio .gitignore.
• compatibilidadAsegúrese de que el cliente es compatible con el protocolo MCP, de lo contrario no podrá comunicarse.
• Apoyo comunitarioSi tiene problemas, envíe sus comentarios a la página de problemas de GitHub y los desarrolladores de la comunidad le ayudarán.

Con los pasos anteriores, puede comenzar rápidamente con Dify Connect MCP, integrar los flujos de trabajo de Dify en sus propios proyectos y disfrutar de una experiencia de desarrollo de IA eficiente.