@coffeerunhobby/mcp-ha-connect 0.5.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,24 @@
+type LogFields = Record<string, unknown>;
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+type LogFormat = 'plain' | 'json' | 'gcp-json';
+/**
+ * Initialize the logger with a specific log level and format.
+ * This should be called once during application startup.
+ * @param level - The minimum log level to output
+ * @param format - The output format (plain, json, or gcp-json)
+ * @param useStderr - If true, logs to stderr instead of stdout (required for stdio transport)
+ */
+export declare function initLogger(level: LogLevel, format?: LogFormat, useStderr?: boolean): void;
+/**
+ * Set the logger level dynamically
+ * @param level - The new log level
+ */
+export declare function setLevel(level: LogLevel): void;
+export declare const logger: {
+    debug(message: string, meta?: LogFields): void;
+    info(message: string, meta?: LogFields): void;
+    warn(message: string, meta?: LogFields): void;
+    error(message: string, meta?: LogFields): void;
+};
+export type { LogLevel, LogFormat, LogFields };
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AA6C/C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAE,SAAmB,EAAE,SAAS,UAAQ,GAAG,IAAI,CAEhG;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAE9C;AA6BD,eAAO,MAAM,MAAM;mBACF,MAAM,SAAS,SAAS;kBAGzB,MAAM,SAAS,SAAS;kBAGxB,MAAM,SAAS,SAAS;mBAGvB,MAAM,SAAS,SAAS;CAGxC,CAAC;AAGF,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,94 @@
+import pino from 'pino';
+const levelToSeverity = {
+    trace: 'DEBUG',
+    debug: 'DEBUG',
+    info: 'INFO',
+    warn: 'WARNING',
+    error: 'ERROR',
+    fatal: 'CRITICAL',
+};
+let instance;
+function createLogger(level = 'info', format = 'plain', useStderr = false) {
+    const baseConfig = {
+        level,
+        base: undefined,
+        messageKey: 'message',
+        timestamp: pino.stdTimeFunctions.isoTime,
+    };
+    // Configure formatters based on format
+    if (format === 'gcp-json') {
+        baseConfig.formatters = {
+            level(label) {
+                return { severity: levelToSeverity[label] ?? label.toUpperCase() };
+            },
+        };
+    }
+    else if (format === 'plain') {
+        baseConfig.formatters = {
+            level(label) {
+                return { level: label.toUpperCase() };
+            },
+        };
+    }
+    // For 'json' format, use default pino JSON output (no special formatters)
+    // When running in stdio mode, always log to stderr to avoid interfering with MCP protocol on stdout
+    return useStderr ? pino(baseConfig, process.stderr) : pino(baseConfig);
+}
+// Initialize with default, will be reconfigured by calling initLogger
+const defaultLevel = process.env.MCP_SERVER_LOG_LEVEL ?? 'info';
+instance = createLogger(defaultLevel);
+/**
+ * Initialize the logger with a specific log level and format.
+ * This should be called once during application startup.
+ * @param level - The minimum log level to output
+ * @param format - The output format (plain, json, or gcp-json)
+ * @param useStderr - If true, logs to stderr instead of stdout (required for stdio transport)
+ */
+export function initLogger(level, format = 'plain', useStderr = false) {
+    instance = createLogger(level, format, useStderr);
+}
+/**
+ * Set the logger level dynamically
+ * @param level - The new log level
+ */
+export function setLevel(level) {
+    instance.level = level;
+}
+function normalizeMeta(meta) {
+    if (!meta) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(meta)) {
+        if (value instanceof Error) {
+            normalized[key] = { message: value.message, stack: value.stack };
+            continue;
+        }
+        normalized[key] = value;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function write(level, message, meta) {
+    const fields = normalizeMeta(meta);
+    if (fields) {
+        instance[level](fields, message);
+    }
+    else {
+        instance[level](message);
+    }
+}
+export const logger = {
+    debug(message, meta) {
+        write('debug', message, meta);
+    },
+    info(message, meta) {
+        write('info', message, meta);
+    },
+    warn(message, meta) {
+        write('warn', message, meta);
+    },
+    error(message, meta) {
+        write('error', message, meta);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/wrapper.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * HTTP Wrapper for Home Assistant MCP Server
+ * Provides REST API endpoints that call MCP tools under the hood
+ * Compatible with legacy mcp-wrapper.js behavior
+ */
+export {};
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/wrapper.js

@@ -0,0 +1,301 @@
+#!/usr/bin/env node
+/**
+ * HTTP Wrapper for Home Assistant MCP Server
+ * Provides REST API endpoints that call MCP tools under the hood
+ * Compatible with legacy mcp-wrapper.js behavior
+ */
+import { createServer } from 'http';
+import { spawn } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Use relative path from wrapper location
+const MCP_PATH = path.join(__dirname, 'index.js');
+const PORT = parseInt(process.env.PORT || '3000', 10);
+// ====== FAIL EARLY VALIDATION ======
+function validateConfig() {
+    const errors = [];
+    if (!process.env.HA_URL)
+        errors.push('ERROR: HA_URL environment variable not set');
+    if (!process.env.HA_TOKEN)
+        errors.push('ERROR: HA_TOKEN environment variable not set');
+    if (process.env.HA_URL && !process.env.HA_URL.startsWith('http')) {
+        errors.push('ERROR: HA_URL must start with http:// or https://');
+    }
+    if (!existsSync(MCP_PATH))
+        errors.push(`ERROR: MCP script not found at: ${MCP_PATH}`);
+    const nodeVersion = process.versions.node.split('.')[0];
+    if (parseInt(nodeVersion) < 18) {
+        errors.push(`ERROR: Node.js 18+ required, found: ${process.versions.node}`);
+    }
+    return errors;
+}
+const configErrors = validateConfig();
+if (configErrors.length > 0) {
+    console.error('\nConfiguration Errors:\n');
+    configErrors.forEach(err => console.error(err));
+    console.error('\nFix these issues before starting:');
+    console.error('export HA_URL=http://homeassistant.10.0.0.19.nip.io:8123');
+    console.error('export HA_TOKEN=your_long_lived_access_token\n');
+    process.exit(1);
+}
+// ====== CORS ======
+const ALLOWED_ORIGINS = new Set([
+    "http://127.0.0.1:8282",
+    "http://localhost:8282"
+]);
+function setCors(req, res) {
+    const origin = req.headers.origin;
+    if (origin && ALLOWED_ORIGINS.has(origin)) {
+        res.setHeader("Access-Control-Allow-Origin", origin);
+        res.setHeader("Vary", "Origin");
+    }
+    else {
+        // LAN/dev friendly. Tighten if you expose this publicly.
+        res.setHeader("Access-Control-Allow-Origin", "*");
+    }
+    res.setHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+    res.setHeader("Access-Control-Max-Age", "86400");
+}
+function extractText(result) {
+    return result?.result?.content?.[0]?.text;
+}
+function tryParseJson(text) {
+    if (typeof text !== 'string')
+        return null;
+    const t = text.trim();
+    if (!t)
+        return null;
+    try {
+        return JSON.parse(t);
+    }
+    catch {
+        return null;
+    }
+}
+function sendJson(res, statusCode, obj) {
+    res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(obj));
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = '';
+        req.on('data', chunk => body += chunk);
+        req.on('end', () => {
+            if (!body.trim())
+                return resolve(null);
+            try {
+                resolve(JSON.parse(body));
+            }
+            catch (e) {
+                reject(new Error(`Invalid JSON body: ${e.message}`));
+            }
+        });
+    });
+}
+// This runs the MCP stdio script once per request
+function runMcpWithJsonInput(jsonObj) {
+    return new Promise((resolve, reject) => {
+        const mcp = spawn('node', [MCP_PATH], {
+            env: {
+                ...process.env,
+                HA_URL: process.env.HA_URL,
+                HA_TOKEN: process.env.HA_TOKEN,
+            },
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        let mcpOutput = '';
+        let mcpError = '';
+        let headerSeen = false;
+        mcp.stdout.on('data', (data) => {
+            const str = data.toString();
+            if (str.includes('Home Assistant MCP server running') || str.includes('MCP server connected and ready')) {
+                headerSeen = true;
+                return;
+            }
+            if (headerSeen)
+                mcpOutput += str;
+        });
+        mcp.stderr.on('data', (data) => {
+            const str = data.toString();
+            if (!str.includes('Home Assistant MCP server running') && !str.includes('MCP server connected and ready')) {
+                mcpError += str;
+            }
+            else {
+                headerSeen = true;
+            }
+        });
+        mcp.stdin.write(JSON.stringify(jsonObj) + '\n');
+        mcp.stdin.end();
+        const timeout = setTimeout(() => {
+            mcp.kill();
+            reject(new Error('MCP timeout after 30s'));
+        }, 30000);
+        mcp.on('close', (code) => {
+            clearTimeout(timeout);
+            if (!mcpOutput.trim()) {
+                reject(new Error(`No output from MCP (exit=${code}). stderr=${mcpError}`));
+                return;
+            }
+            try {
+                const parsed = JSON.parse(mcpOutput.trim());
+                resolve(parsed);
+            }
+            catch (e) {
+                reject(new Error(`Invalid JSON from MCP: ${e.message}. raw=${mcpOutput}`));
+            }
+        });
+        mcp.on('error', (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+function callMcpTool(name, argumentsObj) {
+    const request = {
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: { name, arguments: argumentsObj ?? {} }
+    };
+    return runMcpWithJsonInput(request);
+}
+// ====== SERVER ======
+const server = createServer(async (req, res) => {
+    setCors(req, res);
+    // Preflight
+    if (req.method === "OPTIONS") {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    // Health
+    if (req.method === 'GET' && req.url === '/health') {
+        sendJson(res, 200, {
+            status: 'ok',
+            mcp_path: MCP_PATH,
+            ha_url: process.env.HA_URL,
+            token_configured: !!process.env.HA_TOKEN,
+        });
+        return;
+    }
+    // OpenAPI served from disk
+    if (req.method === 'GET' && (req.url === '/openapi.json' || req.url === '/openapi')) {
+        try {
+            const openApiPath = path.join(__dirname, '..', 'openapi.json');
+            const { readFileSync } = await import('fs');
+            const content = readFileSync(openApiPath, 'utf8');
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(content);
+        }
+        catch (e) {
+            sendJson(res, 500, {
+                error: "Failed to read openapi.json",
+                details: e.message
+            });
+        }
+        return;
+    }
+    // ===== Pretty REST endpoints =====
+    if (req.method === 'POST' && req.url === '/get_all_sensors') {
+        try {
+            const raw = await callMcpTool('getStates', {});
+            const text = extractText(raw);
+            const parsed = tryParseJson(text);
+            if (!parsed || !Array.isArray(parsed.entities)) {
+                sendJson(res, 502, { error: "Unexpected MCP response format", raw });
+                return;
+            }
+            // Filter to sensors only to match legacy behavior
+            const sensors = parsed.entities.filter((e) => e.entity_id?.startsWith('sensor.'));
+            sendJson(res, 200, { count: sensors.length, sensors, raw });
+        }
+        catch (e) {
+            sendJson(res, 500, { error: e.message });
+        }
+        return;
+    }
+    if (req.method === 'POST' && req.url === '/get_sensor_state') {
+        try {
+            const body = await readBody(req);
+            const entity_id = body?.entity_id;
+            if (!entity_id || typeof entity_id !== 'string') {
+                sendJson(res, 400, { error: "Missing required field: entity_id (string)" });
+                return;
+            }
+            const raw = await callMcpTool('getState', { entity_id });
+            const text = extractText(raw);
+            const entity = tryParseJson(text);
+            if (!entity || typeof entity !== 'object') {
+                sendJson(res, 502, { error: "Unexpected MCP response format", raw });
+                return;
+            }
+            sendJson(res, 200, { entity, raw });
+        }
+        catch (e) {
+            sendJson(res, 500, { error: e.message });
+        }
+        return;
+    }
+    if (req.method === 'POST' && req.url === '/control_device') {
+        try {
+            const body = await readBody(req);
+            const domain = body?.domain;
+            const service = body?.service;
+            const data = body?.data ?? {};
+            if (!domain || typeof domain !== 'string') {
+                sendJson(res, 400, { error: "Missing required field: domain (string)" });
+                return;
+            }
+            if (!service || typeof service !== 'string') {
+                sendJson(res, 400, { error: "Missing required field: service (string)" });
+                return;
+            }
+            if (typeof data !== 'object' || Array.isArray(data) || data === null) {
+                sendJson(res, 400, { error: "Field 'data' must be an object" });
+                return;
+            }
+            const raw = await callMcpTool('callService', {
+                domain,
+                service,
+                service_data: data,
+            });
+            const text = extractText(raw);
+            const parsed = tryParseJson(text);
+            sendJson(res, 200, { ok: true, result: parsed ?? text ?? null, raw });
+        }
+        catch (e) {
+            sendJson(res, 500, { error: e.message });
+        }
+        return;
+    }
+    // ===== Raw passthrough endpoint (for n8n compatibility) =====
+    if (req.method === 'POST' && req.url === '/') {
+        try {
+            const body = await readBody(req);
+            if (!body) {
+                sendJson(res, 400, { error: "Empty JSON body" });
+                return;
+            }
+            const result = await runMcpWithJsonInput(body);
+            sendJson(res, 200, result);
+        }
+        catch (e) {
+            sendJson(res, 500, { error: e.message });
+        }
+        return;
+    }
+    sendJson(res, 404, { error: 'Not found' });
+});
+server.listen(PORT, '0.0.0.0', () => {
+    console.log('MCP Wrapper started successfully!');
+    console.log(`Listening on 0.0.0.0:${PORT}`);
+    console.log(`MCP script: ${MCP_PATH}`);
+    console.log(`Home Assistant: ${process.env.HA_URL}`);
+    console.log(`Token: ${process.env.HA_TOKEN ? '***configured***' : 'MISSING'}`);
+    console.log(`\nTest with: curl http://localhost:${PORT}/health\n`);
+});
+//# sourceMappingURL=wrapper.js.map

package/dist/wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"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"}

package/docker-compose.yml

@@ -0,0 +1,17 @@
+services:
+  mcp-ha-connect:
+    build: .
+    container_name: mcp-ha-connect
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    env_file:
+      - .env
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:3000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s

package/docs/CHANGELOG.md

@@ -0,0 +1,86 @@
+### 0.5.0 (January 2026)
+- **Real-time SSE Event Subscription**: Subscribe to Home Assistant events via Server-Sent Events
+  - Filter by domain, entity_id, or event types
+  - Automatic WebSocket connection to Home Assistant
+  - Keep-alive support for persistent connections
+- **Enhanced Automation Management**: Full automation lifecycle support
+  - `triggerAutomation`: Manually trigger automations with variables
+  - `enableAutomation`/`disableAutomation`/`toggleAutomation`: Control automation state
+  - `createAutomation`: Create new automations via API
+  - `deleteAutomation`: Remove automations
+  - `reloadAutomations`: Reload from configuration
+  - `getAutomationTrace`: View execution history
+- **Advanced Device Control Tools**:
+  - `controlLight`: Brightness, color, color temperature, transitions
+  - `controlClimate`: Temperature, HVAC mode, fan mode, presets
+  - `controlMediaPlayer`: Playback, volume, mute controls
+  - `controlCover`: Position and tilt control
+  - `controlFan`: Speed, oscillation, direction
+  - `activateScene`: Scene activation
+  - `runScript`: Script execution with variables
+  - `sendNotification`: Send notifications through Home Assistant
+- **Rate Limiting**: Built-in token bucket rate limiter
+  - Configurable window and request limits
+  - Per-IP tracking with automatic cleanup
+  - Skip paths for health checks
+- **New Configuration Options**:
+  - `MCP_SSE_EVENTS_ENABLED`: Enable/disable SSE
+  - `MCP_SSE_EVENTS_PATH`: Customize SSE endpoint
+  - `MCP_RATE_LIMIT_ENABLED`: Enable/disable rate limiting
+  - `MCP_RATE_LIMIT_WINDOW_MS`: Rate limit window
+  - `MCP_RATE_LIMIT_MAX_REQUESTS`: Max requests per window
+- Total tools increased from 16 to 33
+
+### 0.4.0 (January 2026)
+- **Extensible AI Provider System**: Refactored AI client to support multiple providers
+  - New `src/localAI/` folder with provider-based architecture
+  - Supports Ollama (native API) and OpenAI-compatible APIs (LocalAI, LM Studio, vLLM)
+  - New environment variables: `AI_PROVIDER`, `AI_URL`, `AI_MODEL`, `AI_TIMEOUT`, `AI_API_KEY`
+- Refactored `haClient.ts` into modular folder structure (`src/haClient/`)
+- Split monolithic client into dedicated operation classes:
+  - `request.ts` - HTTP request handler
+  - `states.ts` - State operations (getStates, getState, getAllSensors)
+  - `services.ts` - Service operations (callService, restartServer)
+  - `entities.ts` - Entity operations (getEntitiesByDomain, searchEntities, listEntities, getDomainSummary)
+  - `automations.ts` - Automation operations (getAutomations)
+  - `history.ts` - History operations (getHistory, getSystemLog)
+  - `updates.ts` - Update operations (getAvailableUpdates)
+  - `config.ts` - Config operations (getVersion, getConfig, checkApi)
+  - `index.ts` - Main HaClient class composing all operations
+- Improved code organization following modular architecture pattern
+- No changes to public API or tools - fully backward compatible
+- All 325 tests pass
+
+### 0.3.0 (January 2026)
+- Added 8 new tools: `getVersion`, `entityAction`, `listEntities`, `getDomainSummary`, `listAutomations`, `restartHomeAssistant`, `getSystemLog`, `checkUpdates`
+- Added MCP Resources support with 5 URI-based endpoints (`hass://entities`, etc.)
+- Added `entityAction` tool for simplified turn_on/turn_off/toggle operations
+- Added `listEntities` tool with domain, state, search, and limit filtering
+- Added `getDomainSummary` tool for domain statistics
+- Added `listAutomations` tool for automation management
+- Added `restartHomeAssistant` tool for server control
+- Added `getSystemLog` tool for viewing logbook entries (events, state changes)
+- Added `checkUpdates` tool to check for available updates (Core, Supervisor, OS, add-ons)
+- Total tools increased from 8 to 16
+- Enhanced type definitions for Automation, DomainSummary, HaVersion, LogbookEntry, UpdateInfo
+
+### 0.2.0 (January 2026)
+- Added AI-powered sensor analysis with Ollama
+- Added `getAllSensors` tool
+- Added `analyzeSensors` tool
+- Added `getHistory` tool
+- Added phi4:14b as recommended model (9.5/10, 6.65s avg)
+- Added qwen3:14b support (10/10 accuracy, 12.5s avg)
+- Added comprehensive security documentation
+- Added UFW firewall configuration guide
+- Added n8n workflow examples and import instructions
+- Updated to Node.js 20+ (v20.19.6) and npm 10.8+
+- Updated installation instructions with verified versions
+- Added Docker CLI workflow import method
+- Enhanced troubleshooting with network/firewall diagnostics
+
+### 0.1.0 (Initial Release)
+- Basic Home Assistant integration
+- 5 core tools (getStates, getState, callService, getEntitiesByDomain, searchEntities)
+- Multiple transport modes (stdio, SSE, HTTP streaming)
+- Full TypeScript support