Coreflux MCP Server

Servidor MCP Coreflux MQTT

Este es un servidor de Protocolo de contexto de modelo (MCP) que se conecta a un agente MQTT de Coreflux y hace que las acciones de Coreflux y MQTT estén disponibles como herramientas para Claude y otros asistentes de IA compatibles con MCP.

Características

• Se conecta al bróker MQTT de Coreflux
• Proporciona herramientas para todos los comandos de Coreflux (modelos, acciones, reglas, rutas)
• Descubre y enumera las acciones disponibles
• Incluye documentación del lenguaje LOT como recursos
• Creado con el SDK oficial de MCP para una integración perfecta con Claude
• Asistente de configuración independiente para la configuración

Asistente de configuración

El servidor incluye un asistente de configuración independiente que puede ejecutarse independientemente del servidor principal. Ejecute el asistente de configuración cuando:

• Necesita crear una configuración inicial (archivo .env)
• Desea actualizar su configuración existente
• Tiene problemas de conexión y necesita reconfigurar

Para ejecutar el asistente de configuración:

El asistente de configuración le ayuda a:

• Crea o actualiza el archivo .env con tu configuración
• Configurar los ajustes del agente MQTT (host, puerto, credenciales)
• Configure la configuración TLS si es necesario
• Configurar las opciones de registro

Una vez completada la configuración, puede ejecutar el servidor normalmente.

Conectando a Claude al servidor MCP

Uso de Claude Desktop Config

1. Cree o edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS/Linux) o %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json (Windows)
2. Agregue la siguiente configuración (ajuste las rutas según corresponda):
   { "mcpServers": { "coreflux": { "command": "python", "args": [ "/PATH/TO/server.py", "--mqtt-host", "localhost", "--mqtt-port", "1883", "--mqtt-user", "root", "--mqtt-password", "coreflux", "--mqtt-client-id", "claude-coreflux-client" ], "description": "Coreflux MQTT Broker Control", "icon": "🔄", "env": {} } } }
3. Reiniciar Claude Desktop

Argumentos de la línea de comandos

El servidor acepta los siguientes argumentos de línea de comandos. Estos ajustes también se pueden configurar mediante el archivo .env con el asistente de configuración:

Herramientas disponibles

El servidor proporciona herramientas para comandos comunes de Coreflux:

• add_rule : Agregar una nueva regla de permiso
• remove_rule : Eliminar una regla de permiso
• add_route : Agregar una nueva conexión de ruta
• remove_route : Eliminar una conexión de ruta
• add_model : Agregar una nueva estructura de modelo
• remove_model : Eliminar una estructura de modelo
• add_action : Agregar un nuevo evento/función de acción
• remove_action : Eliminar un evento/función de acción
• run_action : Ejecutar un evento/función de acción
• remove_all_models : Eliminar todos los modelos
• remove_all_actions : Eliminar todas las acciones
• remove_all_routes : Eliminar todas las rutas
• list_discovered_actions : enumera todas las acciones de Coreflux descubiertas
• request_lot_code : Generar código LOT basado en indicaciones en lenguaje natural

Depuración y solución de problemas

Si encuentra problemas:

1. Verifique las credenciales de su agente MQTT en su configuración de Claude
2. Asegúrese de que el corredor sea accesible
3. Ejecute el asistente de configuración para verificar o actualizar su configuración:
   python setup_assistant.py
4. Consulte los registros de Claude Desktop:
   # Check Claude's logs for errors (macOS/Linux) tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows PowerShell Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
5. Ejecute el servidor con registro de depuración:
   # Direct execution with debug logging python server.py --mqtt-host localhost --mqtt-port 1883 --log-level DEBUG

Referencias

• Guía de inicio rápido de MCP para desarrolladores de servidores
• Documentación oficial del MCP