Dify MCP Server

Servidor Dify MCP

Inglés | Chino

Un servidor MCP (Protocolo de Contexto de Modelo) basado en TypeScript que conecta el Cliente MCP con las aplicaciones Dify. Este servidor expone dinámicamente las aplicaciones Dify como herramientas que pueden usarse directamente en el Cliente MCP.

Descripción general

Este servidor implementa el Protocolo de Contexto de Modelo para conectar el Cliente MCP con las aplicaciones Dify. Obtiene dinámicamente las especificaciones de las aplicaciones de las API de Dify y las expone como herramientas MCP. El servidor permite a los usuarios interactuar con múltiples aplicaciones Dify a través de una interfaz unificada dentro del Cliente MCP.

Características

Integración dinámica de Dify

• Se conecta a múltiples aplicaciones Dify mediante claves API
• Obtiene automáticamente metadatos y parámetros de la aplicación
• Genera dinámicamente interfaces de herramientas basadas en las especificaciones de la aplicación Dify
• Admite varios tipos de entrada, incluidos texto, párrafos y menús desplegables de selección.

Manejo de solicitudes

• Manejo robusto de errores con reintentos de solicitud
• Admite modos de respuesta de bloqueo y transmisión
• Manejo de JSON BigInt para valores numéricos grandes

Configuración

• Claves API configuradas a través de variables de entorno
• URL base configurables y configuraciones de tiempo de espera
• Volver a los valores predeterminados cuando las variables de entorno no están disponibles

Instalación

Prerrequisitos

• Node.js (v16 o superior)
• npm o hilo

Configuración

1. Clonar el repositorio

2. Instalar dependencias

3. Construir el proyecto

Integración con Windsurf IDE

Para utilizar con Windsurf IDE, agregue la configuración del servidor a la configuración de MCP:

Variables de entorno

• AGENT_API_KEYS : Lista separada por comas de claves API de Dify
• BASE_URL : URL base para la API de Dify (predeterminada: https://api.dify.ai )
• TIMEOUT : Tiempo de espera de la solicitud en milisegundos (predeterminado: 60000)

Cómo obtener variables de entorno

API密钥(AGENT_API_KEYS): 多个以,分割

Uso

Una vez configurado, el servidor Dify MCP hará lo siguiente:

1. Conéctese a las aplicaciones Dify especificadas utilizando las claves API proporcionadas
2. Obtener metadatos de la aplicación y especificaciones de parámetros
3. Generar interfaces de herramientas MCP basadas en las configuraciones de la aplicación Dify
4. Haga que estas herramientas estén disponibles dentro del IDE de Windsurf

Cada aplicación Dify se expondrá como una herramienta independiente con un formato de nombre de dify_app_info_{application_name} .

Desarrollo

Scripts disponibles

• npm run build : Construye el proyecto
• npm run prepare : Preparar el proyecto para su distribución
• npm run watch : vigila los cambios y reconstruye
• npm run inspector : ejecuta el inspector MCP para depurar

Estructura del proyecto

• src/index.ts : Implementación del servidor principal
• src/request.ts : cliente HTTP para la comunicación de la API de Dify
• src/type.ts : Interfaces de TypeScript para la API de Dify

Solución de problemas

Si encuentra problemas:

1. Verifique que sus claves API sean correctas y tengan los permisos necesarios
2. Compruebe que la BASE_URL sea accesible desde su entorno
3. Revise los registros del servidor para ver mensajes de error detallados
4. Asegúrese de que las aplicaciones de Dify estén configuradas correctamente y sean accesibles

Licencia

Este proyecto está licenciado bajo los términos especificados en el archivo LICENCIA.