mcp-flowise

mcp-flowise es un paquete de Python que implementa un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con la API de Flowise. Proporciona una forma estandarizada y flexible de listar flujos de chat, crear predicciones y registrar dinámicamente herramientas para flujos de chat o asistentes de Flowise.

Admite dos modos de funcionamiento:

• Modo de bajo nivel (predeterminado) : registra dinámicamente herramientas para todos los flujos de chat recuperados de la API de Flowise.

• Modo FastMCP : proporciona herramientas estáticas para enumerar flujos de chat y crear predicciones, adecuadas para configuraciones más simples.

Características

• Exposición de herramientas dinámicas : el modo de nivel bajo crea herramientas dinámicamente para cada flujo de chat o asistente.

• Configuración más simple : el modo FastMCP expone las herramientas list_chatflows y create_prediction para una configuración mínima.

• Filtrado flexible : ambos modos admiten el filtrado de flujos de chat a través de listas blancas y listas negras por ID o nombres (expresiones regulares).

• Integración con MCP : se integra perfectamente en los flujos de trabajo de MCP.

Related MCP server: MCP Python Server

Instalación

Instalación mediante herrería

Para instalar mcp-flowise para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @andydukes/mcp-flowise --client claude

Prerrequisitos

• Python 3.12 o superior

• gestor de paquetes uvx

Instalar y ejecutar a través de uvx

Confirme que puede ejecutar el servidor directamente desde el repositorio de GitHub usando uvx :

uvx --from git+https://github.com/andydukes/mcp-flowise mcp-flowise

Agregar al ecosistema MCP (configuración mcpServers )

Puede integrar mcp-flowise en su ecosistema MCP añadiéndolo a la configuración mcpServers . Ejemplo:

{
    "mcpServers": {
        "mcp-flowise": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/andydukes/mcp-flowise",
                "mcp-flowise"
            ],
            "env": {
                "FLOWISE_API_KEY": "${FLOWISE_API_KEY}",
                "FLOWISE_API_ENDPOINT": "${FLOWISE_API_ENDPOINT}"
            }
        }
    }
}

Modos de operación

1. Modo FastMCP (Modo simple)

Se habilita al configurar FLOWISE_SIMPLE_MODE=true . Este modo:

• Expone dos herramientas: list_chatflows y create_prediction .

• Permite la configuración estática utilizando FLOWISE_CHATFLOW_ID o FLOWISE_ASSISTANT_ID .

• Enumera todos los flujos de chat disponibles a través de list_chatflows .

2. Modo de bajo nivel (FLOWISE_SIMPLE_MODE=Falso)

Características :

• Registra dinámicamente todos los flujos de chat como herramientas independientes.

• Las herramientas reciben el nombre de los flujos de chat (normalizados).

• Utiliza descripciones de la variable FLOWISE_CHATFLOW_DESCRIPTIONS y recurre a los nombres de flujo de chat si no se proporciona ninguna descripción.

Ejemplo :

• my_tool(question: str) -> str creado dinámicamente para un flujo de chat.

Ejecutándose en Windows con uvx

Si usa uvx en Windows y tiene problemas con --from git+https , la solución recomendada es clonar el repositorio localmente y configurar mcpServers con la ruta completa a uvx.exe y al repositorio clonado. Además, incluya APPDATA , LOGLEVEL y otras variables de entorno según sea necesario.

Ejemplo de configuración para el ecosistema MCP ( mcpServers en Windows)

{
  "mcpServers": {
    "flowise": {
      "command": "C:\\Users\\matth\\.local\\bin\\uvx.exe",
      "args": [
        "--from",
        "C:\\Users\\matth\\downloads\\mcp-flowise",
        "mcp-flowise"
      ],
      "env": {
        "LOGLEVEL": "ERROR",
        "APPDATA": "C:\\Users\\matth\\AppData\\Roaming",
        "FLOWISE_API_KEY": "your-api-key-goes-here",
        "FLOWISE_API_ENDPOINT": "http://localhost:3010/"
      }
    }
  }
}

Notas

• Rutas completas : utilice rutas completas tanto para uvx.exe como para el repositorio clonado.

• Variables de entorno : apunte APPDATA a su perfil de usuario de Windows (por ejemplo, C:\\Users\\<username>\\AppData\\Roaming ) si es necesario.

• Nivel de registro : ajuste LOGLEVEL según sea necesario ( ERROR , INFO , DEBUG , etc.).

Variables de entorno

General

• FLOWISE_API_KEY : Su token portador de API de Flowise ( obligatorio ).

• FLOWISE_API_ENDPOINT : URL base para Flowise (predeterminado: http://localhost:3010 ).

Modo de bajo nivel (predeterminado)

• FLOWISE_CHATFLOW_DESCRIPTIONS : Lista de pares de chatflow_id:description separados por comas. Ejemplo:

  FLOWISE_CHATFLOW_DESCRIPTIONS="abc123:Chatflow One,xyz789:Chatflow Two"

Modo FastMCP ( FLOWISE_SIMPLE_MODE=true )

• FLOWISE_CHATFLOW_ID : ID de flujo de chat único (opcional).

• FLOWISE_ASSISTANT_ID : ID de asistente único (opcional).

• FLOWISE_CHATFLOW_DESCRIPTION : Descripción opcional para la herramienta única expuesta.

Filtrado de flujos de chat

Los filtros se pueden aplicar en ambos modos utilizando las siguientes variables de entorno:

• Lista blanca por ID :
  FLOWISE_WHITELIST_ID="id1,id2,id3"

• Lista negra por ID :
  FLOWISE_BLACKLIST_ID="id4,id5"

• Lista blanca por nombre (expresión regular) :
  FLOWISE_WHITELIST_NAME_REGEX=".*important.*"

• Lista negra por nombre (expresión regular) :
  FLOWISE_BLACKLIST_NAME_REGEX=".*deprecated.*"

Nota : Las listas blancas prevalecen sobre las negras. Si se configuran ambas, se aplica la regla más restrictiva.

Seguridad

• Proteja su clave API : asegúrese de que FLOWISE_API_KEY se mantenga segura y no esté expuesta en registros o repositorios.

• Configuración del entorno : utilice archivos .env o variables de entorno para configuraciones sensibles.

Añade .env a tu .gitignore :

# .gitignore
.env

Solución de problemas

• Clave API faltante : asegúrese de que FLOWISE_API_KEY esté configurada correctamente.

• Configuración no válida : si se configuran FLOWISE_CHATFLOW_ID y FLOWISE_ASSISTANT_ID , el servidor se negará a iniciarse.

• Errores de conexión : Verifique que FLOWISE_API_ENDPOINT sea accesible.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

HACER

• [x] Modo Fastmcp

• [x] Modo de bajo nivel

• [x] Filtrado

• [x] Integración de escritorio de Claude

• [ ] Asistentes