High-performance Rust implementation of Model Context Protocol (MCP) server for Loxone home automation systems. Enables AI assistants to control lights, blinds, sensors, and weather data through natural language commands.
📖 Landing Page | ⚡ Quick Start | 📋 Documentation | 🐍 Python Legacy
This project has been completely rewritten in Rust for superior performance, reliability, and deployment flexibility.
- 🚀 10-100x Performance: Rust's zero-cost abstractions and async runtime
- 🔧 23+ MCP Tools: Comprehensive home automation control
- 🌐 Multi-Platform: WASM, Docker, native binaries, HTTP/SSE
- 🔐 Advanced Security: Infisical integration, consent management, audit trails
- 🎯 Batch Operations: Parallel device control with automatic optimization
- 📊 Health Monitoring: Real-time metrics, connection pooling, error tracking
- 🔄 Workflow Engine: n8n integration with visual automation builder
git clone https://github.com/avrabe/mcp-loxone.git
cd mcp-loxone/loxone-mcp-rust
cargo build --release
./target/release/loxone-mcp-rust --helpContinue reading: loxone-mcp-rust/README.md
- Rust 1.75+ (install via rustup)
- Loxone Miniserver
- Optional: Docker for containerized deployment
cd loxone-mcp-rust
cargo install --path .
loxone-mcp-rust --host 192.168.1.100 --username admincd loxone-mcp-rust
docker build -t loxone-mcp .
docker run -p 8080:8080 loxone-mcpcd loxone-mcp-rust
wasm-pack build --target web
# Serve with any HTTP server// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"loxone": {
"command": "loxone-mcp-rust",
"args": ["--mcp-mode"]
}
}
}The Python implementation has been archived to archive/python-legacy/. The new Rust version provides:
- ⚡ 10-100x faster execution - Zero-cost async operations
- 🛡️ Enhanced security - Consent management and audit logging
- 🔧 More tools - 23+ vs ~10 in Python version
- 🌐 Better deployment - WASM, native binaries, containerization
- 📊 Monitoring - Health checks, metrics, connection pooling
-
Archive your Python config (if needed):
cp ~/.config/loxone-mcp/* ~/backup/
-
Switch to Rust version:
cd loxone-mcp-rust cargo build --release ./target/release/loxone-mcp-rust setup -
Update Claude Desktop config to use the new binary path
- Parallel device control with automatic optimization
- Rate limiting and connection pooling
- Graceful error handling and partial success reporting
- Interactive approval for sensitive operations
- Configurable security policies
- Comprehensive audit trails
- Real-time connection and performance metrics
- Automatic retry logic with exponential backoff
- Health check endpoints for monitoring systems
- n8n visual automation builder
- Event-driven architecture
- Custom workflow templates
- Multi-backend credential storage: Infisical → Keychain → Environment variables
- Consent management: Interactive approval for sensitive operations
- Audit trails: Comprehensive logging of all security-related actions
- Connection security: TLS support with certificate validation
- Rate limiting: Protection against API abuse and DoS attacks
- Verify your Loxone Miniserver is accessible:
loxone-mcp-rust health-check - Check network connectivity and firewall settings
- Ensure your user has sufficient permissions in Loxone Config
- Re-run setup:
loxone-mcp-rust setup - Verify credentials in Loxone Config software
- Check credential backend status:
loxone-mcp-rust verify-credentials
- Monitor connection pool:
loxone-mcp-rust stats - Check resource usage:
loxone-mcp-rust health-check --detailed - Review error logs for patterns
cd loxone-mcp-rust
cargo build --release
cargo test- See CONTRIBUTING.md for guidelines
- Run tests:
cargo test - Check linting:
cargo clippy - Format code:
cargo fmt
- Add tool implementation in
src/tools/ - Register in
src/mcp_server.rs - Add tests in
tests/ - Update documentation in
src/tools/documentation.rs
MIT License - Copyright (c) 2025 Ralf Anton Beier
- Built with FastMCP
- Custom WebSocket implementation for Loxone communication
- Implements the Model Context Protocol