How ikari-software/fibaro-mcp works
Fibaro MCP Server exposes Fibaro Home Center capabilities as MCP tools: an MCP client makes requests, handlers dispatch them to the Fibaro API client or specialized feature modules, and results return through MCP. The documented feature branches include device and scene management, bulk operations, templates, Lua REPL, backups, history and analytics, energy data, automation generation, and integrations. Specialized module links are supported by the SOURCE INDEX; unsampled handler details limit certainty about some individual routes.
Main entry points: mcp-handlers.ts Tool handlers · workflow-engine.ts Automation builder · fibaro-client.ts Fibaro API client · index.ts Server startup
Components 20
MCP interface
- Server startup
src/index.ts - Tool handlers
src/mcp-handlers.ts
Fibaro access
- Fibaro API client
src/fibaro-client.ts - Energy aggregation
src/energy-aggregator.ts - Logging
src/logger.ts
Home features
- Bulk device operations
src/bulk/bulk-operations.ts - Bulk query engine
src/bulk/query-engine.ts - Backup and restore
src/backup/backup-manager.ts - History manager
src/history/history-manager.ts - Analytics engine
src/history/analytics-engine.ts - Scene templates
src/templates/template-manager.ts - Template library
data/scene-templates - Lua REPL
src/repl/lua-repl.ts - REPL sandbox
src/repl/sandbox-manager.ts
Advanced features
- Automation builder
src/automation/workflow-engine.ts - Lua sanitization
src/automation/lua-sanitizer.ts - Webhook server
src/integrations/webhook-server.ts - MQTT bridge
src/integrations/mqtt-bridge.ts
Other components
- MCP client
- Fibaro Home Center
Connections 21
- MCP client → Server startup: starts over stdio
README.md - Server startup → Tool handlers: serves tools
README.md - Tool handlers → Fibaro API client: dispatches API calls
src/mcp-handlers.ts - Fibaro API client → Fibaro Home Center: calls REST API
src/fibaro-client.ts - Tool handlers → Energy aggregation: requests energy data
src/mcp-handlers.ts - Tool handlers → Bulk device operations: dispatches bulk tools
src/mcp-handlers.ts - Bulk device operations → Bulk query engine: filters devices
src/bulk/bulk-operations.ts - Tool handlers → Backup and restore: dispatches backup tools
src/mcp-handlers.ts - Tool handlers → History manager: dispatches history tools
src/mcp-handlers.ts - Tool handlers → Analytics engine: requests analytics
src/mcp-handlers.ts - Tool handlers → Scene templates: dispatches template tools
src/mcp-handlers.ts - Scene templates → Template library: loads templates
src/templates/template-manager.ts - Tool handlers → Lua REPL: dispatches REPL tools
src/mcp-handlers.ts - Lua REPL → REPL sandbox: manages sessions
src/repl/lua-repl.ts - Tool handlers → Automation builder: dispatches automation tools
src/mcp-handlers.ts - Automation builder → Lua sanitization: sanitizes Lua
src/automation/workflow-engine.ts - Automation builder → Fibaro API client: deploys scenes
src/automation/workflow-engine.ts - Tool handlers → Webhook server: dispatches integration tools
src/mcp-handlers.ts - Tool handlers → MQTT bridge: dispatches integration tools
src/mcp-handlers.ts - Webhook server → Fibaro Home Center: triggers scene actions
src/integrations/webhook-server.ts - Energy aggregation → Logging: logs operations