feat: implement dynamic capability detection and generic system archi…#8
Merged
feat: implement dynamic capability detection and generic system archi…#8
Conversation
…tecture Major architectural improvements to make the MCP server generic and configuration-aware: Core Features Added: - Dynamic capability detection system that analyzes each user's specific Loxone configuration - Real-time WebSocket monitoring with automatic sensor discovery - Token-based authentication for improved security - State logging and change tracking for door/window sensors - Comprehensive error handling with helpful capability guidance Architecture Changes: - SystemCapabilities dataclass for detecting available features at startup - Intelligent device categorization by type, category, and name patterns - Generic MCP tools that adapt to available devices rather than assuming hardcoded setups - Configuration-aware error messages that prevent AI confusion about missing devices New Components: - LoxoneTokenClient: Secure JWT authentication replacing basic auth - LoxoneWebSocketClient: Real-time state monitoring for Gen 1 systems - DynamicSensorDiscovery: Automatic detection of functional sensors - SensorStateLogger: Persistent logging of sensor state changes Landing Page Updates: - Removed all hardcoded device counts and specific configuration references - Updated to reflect generic, capability-aware nature of the system - Added terminal demo showing capability detection during setup - Matrix animation now shows generic capability data instead of hardcoded device states Testing & Documentation: - Comprehensive test suite covering all major components - Updated CLAUDE.md with new architecture patterns - Added MCP usage examples and deployment documentation Breaking Changes: - Server now requires capability detection at startup - Tools check availability before execution to prevent errors - Landing page reflects generic nature rather than specific device counts This transformation addresses the critical requirement that "the AI tries to do something it can't" by implementing comprehensive capability detection and configuration-aware operation.
… functionality - Add complete SSE API key authentication system with Bearer token and X-API-Key support - Integrate SSE API key management into credential setup wizard with auto-generation - Implement JWT token authentication for MCP server with automatic refresh - Add comprehensive weather forecast functionality using Open-Meteo and OpenWeatherMap APIs - Fix 867 linting errors across entire codebase for CI compatibility - Enhance server initialization with lazy loading and connection health monitoring - Update documentation with security architecture deployment diagrams - Add production-ready Docker configuration with environment variable overrides - Implement constant-time API key comparison for timing attack prevention - Add sensor state logging and dynamic discovery with background processing BREAKING CHANGE: Authentication is now required for SSE endpoints by default. Set LOXONE_SSE_REQUIRE_AUTH=false to disable authentication. Security improvements: - All credentials stored in OS keychain with environment variable fallback - HMAC-SHA256 JWT tokens for MCP authentication - 32-byte cryptographically secure API keys for SSE - Request logging with client IP tracking for security monitoring - Health check endpoints remain unauthenticated for monitoring New features: - Daily and hourly weather forecasts with location auto-detection - Complete sensor state history tracking with JSON persistence - Dynamic sensor discovery without hardcoded UUIDs - Production deployment with Docker Compose - Comprehensive system capability detection Documentation updates: - Replace setup wizard flow with deployment architecture diagram - Add visual security flow showing JWT and API key authentication - Update index.html with complete security architecture visualization - Fix layout overlaps in deployment diagram
- Fix critical syntax error in sse_server.py (global declaration order) - Fix all linting errors (line length, type annotations, whitespace) - Fix security issue with SHA1 usage (added usedforsecurity=False) - Add MCP prompt for system overview to satisfy validation - Implement comprehensive HTTPS/SSL support for SSE server - Add SSL configuration module with certificate validation - Create setup scripts for local and production HTTPS - Update documentation with HTTPS setup instructions - Add uv installation commands to index.html - Make all CI checks pass (linting, security, MCP validation) The CI should now pass all tests successfully.
Applied ruff format to fix formatting violations in: - src/loxone_mcp/server.py - src/loxone_mcp/sse_server.py - src/loxone_mcp/ssl_config.py
avrabe
force-pushed
the
autodiscover
branch
2 times, most recently
from
2128419 to
72e488a
Compare
…ing dependencies - Add fastapi>=0.104.0 dependency to fix SSE server imports - Rewrite test files to match current server.py structure - Remove tests for non-existent functions (LoxoneDevice, find_matching_room, etc.) - Fix ServerContext constructor usage in all test files - Clean up linting issues and ensure code quality standards - Tests now properly reflect the actual codebase implementation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
…tecture
Major architectural improvements to make the MCP server generic and configuration-aware:
Core Features Added:
Architecture Changes:
New Components:
Landing Page Updates:
Testing & Documentation:
Breaking Changes:
This transformation addresses the critical requirement that "the AI tries to do something it can't" by implementing comprehensive capability detection and configuration-aware operation.
Description
Type of Change
Related Issue
Fixes #(issue number)
Changes Made
Testing
Checklist
Screenshots (if applicable)
Additional Notes