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

Clonar el repositorio

git clone https://github.com/zhuzhoulin/dify-mcp-server.git
cd dify-mcp-server

Instalar dependencias

npm install

Construir el proyecto

npm run build

Integración con Windsurf IDE

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

{
  "mcpServers": {
    "dify-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/dify-mcp-server/build/index.js"
      ],
      "env": {
        "AGENT_API_KEYS": "key1,key2,key3",
        "BASE_URL": "https://api.dify.ai",
        "TIMEOUT": "60000"
      }
    }
  }
}

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:

Conéctese a las aplicaciones Dify especificadas utilizando las claves API proporcionadas
Obtener metadatos de la aplicación y especificaciones de parámetros
Generar interfaces de herramientas MCP basadas en las configuraciones de la aplicación Dify
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:

Verifique que sus claves API sean correctas y tengan los permisos necesarios
Compruebe que la BASE_URL sea accesible desde su entorno
Revise los registros del servidor para ver mensajes de error detallados
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.