Coreflux MQTT MCP 서버

이는 Coreflux MQTT 브로커에 연결하고 Coreflux 및 MQTT 작업을 Claude 및 기타 MCP 호환 AI 어시스턴트를 위한 도구로 사용할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

특징

• Coreflux MQTT 브로커에 연결합니다.
• 모든 Coreflux 명령(모델, 작업, 규칙, 경로)에 대한 도구를 제공합니다.
• 사용 가능한 작업을 검색하고 나열합니다.
• LOT 언어 문서를 리소스로 포함합니다.
• 원활한 Claude 통합을 위해 공식 MCP SDK로 구축됨
• 구성을 위한 독립 실행형 설정 도우미

설정 도우미

서버에는 메인 서버와 별도로 실행할 수 있는 독립형 설정 도우미가 포함되어 있습니다. 다음과 같은 경우 설정 도우미를 실행하세요.

• 초기 구성(.env 파일)을 만들어야 합니다.
• 기존 구성을 업데이트하려고 합니다.
• 연결 문제가 발생하여 재구성해야 합니다.

설정 도우미를 실행하려면:

지엑스피1

설정 도우미는 다음과 같은 작업에 도움을 줍니다.

• 구성에 따라 .env 파일을 생성하거나 업데이트합니다.
• MQTT 브로커 설정(호스트, 포트, 자격 증명) 구성
• 필요한 경우 TLS 구성을 설정하세요
• 로깅 옵션 구성

구성이 완료되면 서버를 정상적으로 실행할 수 있습니다.

Claude를 MCP 서버에 연결

Claude Desktop Config 사용

1. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS/Linux) 또는 %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json (Windows)을 만들거나 편집합니다.
2. 다음 구성을 추가합니다(경로를 적절히 조정합니다):
   { "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. Claude Desktop을 다시 시작하세요

명령줄 인수

서버는 다음 명령줄 인수를 허용합니다. 이러한 설정은 설정 도우미를 사용하여 .env 파일을 통해서도 구성할 수 있습니다.

사용 가능한 도구

서버는 일반적인 Coreflux 명령에 대한 도구를 제공합니다.

• add_rule : 새로운 권한 규칙을 추가합니다.
• remove_rule : 권한 규칙을 제거합니다.
• add_route : 새로운 경로 연결을 추가합니다
• remove_route : 경로 연결을 제거합니다.
• add_model : 새로운 모델 구조를 추가합니다
• remove_model : 모델 구조 제거
• add_action : 새로운 액션 이벤트/함수를 추가합니다.
• remove_action : 액션 이벤트/함수 제거
• run_action : 액션 이벤트/함수를 실행합니다.
• remove_all_models : 모든 모델 제거
• remove_all_actions : 모든 작업 제거
• remove_all_routes : 모든 경로 제거
• list_discovered_actions : 발견된 모든 Coreflux 작업을 나열합니다.
• request_lot_code : 자연어 프롬프트를 기반으로 LOT 코드 생성

디버깅 및 문제 해결

문제가 발생하는 경우:

1. Claude 구성에서 MQTT 브로커 자격 증명을 확인하세요.
2. 브로커가 접근 가능한지 확인하세요
3. 설정을 확인하거나 업데이트하려면 설정 도우미를 실행하세요.
   python setup_assistant.py
4. 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. 디버그 로깅을 사용하여 서버를 실행합니다.
   # Direct execution with debug logging python server.py --mqtt-host localhost --mqtt-port 1883 --log-level DEBUG

참고문헌

• 서버 개발자를 위한 MCP 빠른 시작
• MCP 공식 문서