@coffeerunhobby/mcp-ha-connect 0.5.0

package/dist/server/rateLimiter.js

@@ -0,0 +1,156 @@
+/**
+ * Rate Limiter Middleware
+ * Simple token bucket rate limiter for HTTP endpoints
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * Rate Limiter class
+ */
+export class RateLimiter {
+    windowMs;
+    maxRequests;
+    skipPaths;
+    keyGenerator;
+    entries = new Map();
+    cleanupInterval = null;
+    constructor(config = {}) {
+        this.windowMs = config.windowMs ?? 60000; // 1 minute default
+        this.maxRequests = config.maxRequests ?? 100; // 100 requests per minute
+        this.skipPaths = new Set(config.skipPaths ?? ['/health', '/healthcheck']);
+        this.keyGenerator = config.keyGenerator ?? this.defaultKeyGenerator;
+        // Start cleanup interval to prevent memory leaks
+        this.startCleanup();
+    }
+    /**
+     * Default key generator - uses IP address
+     */
+    defaultKeyGenerator(req) {
+        // Try to get real IP from common proxy headers
+        const forwardedFor = req.headers['x-forwarded-for'];
+        if (forwardedFor) {
+            const ips = Array.isArray(forwardedFor) ? forwardedFor[0] : forwardedFor;
+            return ips.split(',')[0].trim();
+        }
+        const realIp = req.headers['x-real-ip'];
+        if (realIp) {
+            return Array.isArray(realIp) ? realIp[0] : realIp;
+        }
+        // Fall back to socket remote address
+        return req.socket.remoteAddress ?? 'unknown';
+    }
+    /**
+     * Start periodic cleanup of expired entries
+     */
+    startCleanup() {
+        // Cleanup every window period
+        this.cleanupInterval = setInterval(() => {
+            const now = Date.now();
+            let cleaned = 0;
+            for (const [key, entry] of this.entries) {
+                if (now - entry.windowStart > this.windowMs * 2) {
+                    this.entries.delete(key);
+                    cleaned++;
+                }
+            }
+            if (cleaned > 0) {
+                logger.debug('Rate limiter cleanup', { entriesRemoved: cleaned, remaining: this.entries.size });
+            }
+        }, this.windowMs);
+    }
+    /**
+     * Stop cleanup interval
+     */
+    stop() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    /**
+     * Check if request should be allowed
+     */
+    check(req) {
+        const url = req.url ?? '/';
+        const path = url.split('?')[0];
+        // Skip rate limiting for certain paths
+        if (this.skipPaths.has(path)) {
+            return { allowed: true, remaining: this.maxRequests, resetTime: 0 };
+        }
+        const key = this.keyGenerator(req);
+        const now = Date.now();
+        let entry = this.entries.get(key);
+        // Create new entry or reset if window expired
+        if (!entry || now - entry.windowStart > this.windowMs) {
+            entry = { count: 0, windowStart: now };
+            this.entries.set(key, entry);
+        }
+        // Increment count
+        entry.count++;
+        const remaining = Math.max(0, this.maxRequests - entry.count);
+        const resetTime = entry.windowStart + this.windowMs;
+        if (entry.count > this.maxRequests) {
+            logger.warn('Rate limit exceeded', {
+                key,
+                count: entry.count,
+                limit: this.maxRequests,
+                path,
+            });
+            return { allowed: false, remaining: 0, resetTime };
+        }
+        return { allowed: true, remaining, resetTime };
+    }
+    /**
+     * Middleware function for HTTP server
+     */
+    middleware() {
+        return (req, res) => {
+            const result = this.check(req);
+            // Add rate limit headers
+            res.setHeader('X-RateLimit-Limit', this.maxRequests.toString());
+            res.setHeader('X-RateLimit-Remaining', result.remaining.toString());
+            res.setHeader('X-RateLimit-Reset', Math.ceil(result.resetTime / 1000).toString());
+            if (!result.allowed) {
+                res.setHeader('Retry-After', Math.ceil((result.resetTime - Date.now()) / 1000).toString());
+                res.writeHead(429, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    error: 'Too Many Requests',
+                    message: 'Rate limit exceeded. Please try again later.',
+                    retryAfter: Math.ceil((result.resetTime - Date.now()) / 1000),
+                }));
+                return false;
+            }
+            return true;
+        };
+    }
+    /**
+     * Get current stats
+     */
+    getStats() {
+        return {
+            totalEntries: this.entries.size,
+            config: {
+                windowMs: this.windowMs,
+                maxRequests: this.maxRequests,
+            },
+        };
+    }
+    /**
+     * Reset rate limit for a specific key
+     */
+    reset(key) {
+        return this.entries.delete(key);
+    }
+    /**
+     * Clear all rate limit entries
+     */
+    clear() {
+        this.entries.clear();
+    }
+}
+/**
+ * Create a rate limiter instance with default config
+ */
+export function createRateLimiter(config) {
+    return new RateLimiter(config);
+}
+//# sourceMappingURL=rateLimiter.js.map

package/dist/server/rateLimiter.js.map

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

package/dist/server/sse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SSE (Server-Sent Events) transport for MCP server
+ * Implements the legacy MCP protocol version 2024-11-05
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import type { EnvironmentConfig } from '../config.js';
+import type { HaClient } from '../haClient/index.js';
+import type { LocalAIClient } from '../localAI/index.js';
+import { createServer } from './common.js';
+interface SSETransportState {
+    transport: SSEServerTransport;
+    server: ReturnType<typeof createServer>;
+}
+/**
+ * Creates an SSE transport for handling HTTP+SSE connections
+ */
+export declare function createSseTransport(client: HaClient, config: EnvironmentConfig, endpoint: string, res: ServerResponse, aiClient?: LocalAIClient): SSETransportState;
+/**
+ * Handles SSE connection establishment (GET request)
+ */
+export declare function handleSseConnection(client: HaClient, config: EnvironmentConfig, endpoint: string, req: IncomingMessage, res: ServerResponse, aiClient?: LocalAIClient): Promise<SSETransportState>;
+/**
+ * Handles SSE message POST requests
+ */
+export declare function handleSseMessage(transport: SSEServerTransport, req: IncomingMessage, res: ServerResponse, parsedBody?: unknown): Promise<void>;
+/**
+ * Returns the message endpoint path for SSE transport
+ */
+export declare function getSseMessagePath(): string;
+export type { SSETransportState };
+//# sourceMappingURL=sse.d.ts.map

package/dist/server/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/server/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,UAAU,iBAAiB;IACzB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,aAAa,GACvB,iBAAiB,CAgBnB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA+B5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,kBAAkB,EAC7B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAGD,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/server/sse.js

@@ -0,0 +1,76 @@
+/**
+ * SSE (Server-Sent Events) transport for MCP server
+ * Implements the legacy MCP protocol version 2024-11-05
+ */
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { logger } from '../utils/logger.js';
+import { createServer } from './common.js';
+const MESSAGE_PATH = '/messages';
+/**
+ * Creates an SSE transport for handling HTTP+SSE connections
+ */
+export function createSseTransport(client, config, endpoint, res, aiClient) {
+    const mcpServer = createServer(client, aiClient);
+    const transport = new SSEServerTransport(endpoint, res, {
+        allowedOrigins: config.httpAllowedOrigins,
+        enableDnsRebindingProtection: true,
+    });
+    transport.onerror = (error) => {
+        logger.error('SSE transport error', {
+            error,
+            message: error.message,
+        });
+    };
+    return { transport, server: mcpServer };
+}
+/**
+ * Handles SSE connection establishment (GET request)
+ */
+export async function handleSseConnection(client, config, endpoint, req, res, aiClient) {
+    const originHeader = req.headers.origin;
+    const hostHeader = req.headers.host;
+    logger.info('SSE connection request received', {
+        method: req.method,
+        url: req.url,
+        origin: originHeader ?? '(not set)',
+        host: hostHeader ?? '(not set)',
+    });
+    try {
+        const { transport, server } = createSseTransport(client, config, endpoint, res, aiClient);
+        await server.connect(transport);
+        await transport.start();
+        logger.info('SSE connection established', {
+            sessionId: transport.sessionId,
+        });
+        return { transport, server };
+    }
+    catch (error) {
+        logger.error('Failed to establish SSE connection', {
+            error,
+            origin: originHeader ?? '(not set)',
+            host: hostHeader ?? '(not set)',
+            allowedOrigins: config.httpAllowedOrigins,
+        });
+        throw error;
+    }
+}
+/**
+ * Handles SSE message POST requests
+ */
+export async function handleSseMessage(transport, req, res, parsedBody) {
+    logger.debug('SSE message received', {
+        sessionId: transport.sessionId,
+        hasBody: !!parsedBody,
+    });
+    await transport.handlePostMessage(req, res, parsedBody);
+    logger.debug('SSE message handled', {
+        sessionId: transport.sessionId,
+    });
+}
+/**
+ * Returns the message endpoint path for SSE transport
+ */
+export function getSseMessagePath() {
+    return MESSAGE_PATH;
+}
+//# sourceMappingURL=sse.js.map

package/dist/server/sse.js.map

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

package/dist/server/stdio.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stdio transport for MCP server
+ * Used for Claude Desktop and other stdio-based clients
+ */
+import type { HaClient } from '../haClient/index.js';
+import type { LocalAIClient } from '../localAI/index.js';
+export declare function startStdioServer(client: HaClient, aiClient?: LocalAIClient): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/server/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/server/stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhG"}

package/dist/server/stdio.js

@@ -0,0 +1,16 @@
+/**
+ * Stdio transport for MCP server
+ * Used for Claude Desktop and other stdio-based clients
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { logger } from '../utils/logger.js';
+import { createServer } from './common.js';
+export async function startStdioServer(client, aiClient) {
+    logger.info('Starting stdio server');
+    const server = createServer(client, aiClient);
+    const transport = new StdioServerTransport();
+    logger.info('Connecting stdio server');
+    await server.connect(transport);
+    logger.info('Stdio server connected and ready');
+}
+//# sourceMappingURL=stdio.js.map

package/dist/server/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/server/stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAgB,EAAE,QAAwB;IAC/E,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAErC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;AAClD,CAAC"}

package/dist/server/stream.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Streamable HTTP transport for MCP server
+ * Implements the MCP protocol version 2025-03-26 (current/recommended)
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import type { EnvironmentConfig } from '../config.js';
+import type { HaClient } from '../haClient/index.js';
+import type { LocalAIClient } from '../localAI/index.js';
+import { createServer } from './common.js';
+interface StreamTransportState {
+    transport: StreamableHTTPServerTransport;
+    server: ReturnType<typeof createServer>;
+}
+export type { StreamTransportState };
+/**
+ * Creates a Streamable HTTP transport
+ * This implements the MCP protocol version 2025-03-26
+ */
+export declare function createStreamTransport(client: HaClient, config: EnvironmentConfig, aiClient?: LocalAIClient): StreamTransportState;
+/**
+ * Handles incoming Streamable HTTP requests (GET, POST, DELETE)
+ * For stateful mode, transports should be stored and reused by the caller
+ */
+export declare function handleStreamRequest(client: HaClient, config: EnvironmentConfig, req: IncomingMessage, res: ServerResponse, parsedBody?: unknown, existingTransport?: StreamTransportState, aiClient?: LocalAIClient): Promise<StreamTransportState | void>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/server/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/server/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,UAAU,oBAAoB;IAC5B,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;CACzC;AAGD,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,oBAAoB,CA8BjI;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,UAAU,CAAC,EAAE,OAAO,EACpB,iBAAiB,CAAC,EAAE,oBAAoB,EACxC,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA0CtC"}

package/dist/server/stream.js

@@ -0,0 +1,81 @@
+/**
+ * Streamable HTTP transport for MCP server
+ * Implements the MCP protocol version 2025-03-26 (current/recommended)
+ */
+import { randomUUID } from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { logger } from '../utils/logger.js';
+import { createServer } from './common.js';
+/**
+ * Creates a Streamable HTTP transport
+ * This implements the MCP protocol version 2025-03-26
+ */
+export function createStreamTransport(client, config, aiClient) {
+    const mcpServer = createServer(client, aiClient);
+    const enableStatefulSessions = config.stateful;
+    const sessionIdGenerator = enableStatefulSessions ? () => randomUUID() : undefined;
+    if (!enableStatefulSessions) {
+        logger.info('Starting Streamable HTTP transport in stateless mode; Mcp-Session-Id headers are optional');
+    }
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator,
+        allowedOrigins: config.httpAllowedOrigins,
+        enableDnsRebindingProtection: true,
+        onsessioninitialized: (sessionId) => {
+            logger.info('Session initialized', { sessionId });
+        },
+        onsessionclosed: (sessionId) => {
+            logger.info('Session closed', { sessionId });
+        },
+    });
+    transport.onerror = (error) => {
+        logger.error('Streamable HTTP transport error', {
+            error,
+            message: error.message,
+        });
+    };
+    return { transport, server: mcpServer };
+}
+/**
+ * Handles incoming Streamable HTTP requests (GET, POST, DELETE)
+ * For stateful mode, transports should be stored and reused by the caller
+ */
+export async function handleStreamRequest(client, config, req, res, parsedBody, existingTransport, aiClient) {
+    const originHeader = req.headers.origin;
+    const hostHeader = req.headers.host;
+    logger.info('Streamable HTTP request received', {
+        method: req.method,
+        url: req.url,
+        sessionId: req.headers['mcp-session-id'] ?? undefined,
+        origin: originHeader ?? '(not set)',
+        host: hostHeader ?? '(not set)',
+    });
+    // Reuse existing transport if provided, otherwise create new one
+    const state = existingTransport ?? createStreamTransport(client, config, aiClient);
+    if (!existingTransport) {
+        await state.server.connect(state.transport);
+    }
+    try {
+        await state.transport.handleRequest(req, res, parsedBody);
+        logger.debug('Streamable HTTP request handled', {
+            method: req.method,
+            sessionId: req.headers['mcp-session-id'] ?? undefined,
+        });
+    }
+    catch (error) {
+        logger.error('Failed to handle Streamable HTTP request', {
+            error,
+            method: req.method,
+            url: req.url,
+            origin: originHeader ?? '(not set)',
+            host: hostHeader ?? '(not set)',
+            allowedOrigins: config.httpAllowedOrigins,
+        });
+        throw error;
+    }
+    // Return state for session management if stateful
+    if (config.stateful) {
+        return state;
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/server/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/server/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAInG,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAgB,EAAE,MAAyB,EAAE,QAAwB;IACzG,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEjD,MAAM,sBAAsB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/C,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnF,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB;QAClB,cAAc,EAAE,MAAM,CAAC,kBAAkB;QACzC,4BAA4B,EAAE,IAAI;QAClC,oBAAoB,EAAE,CAAC,SAAiB,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,eAAe,EAAE,CAAC,SAAiB,EAAE,EAAE;YACrC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC,CAAC;IAEH,SAAS,CAAC,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;QACnC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE;YAC9C,KAAK;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAgB,EAChB,MAAyB,EACzB,GAAoB,EACpB,GAAmB,EACnB,UAAoB,EACpB,iBAAwC,EACxC,QAAwB;IAExB,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAEpC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;QAC9C,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,SAAS;QACrD,MAAM,EAAE,YAAY,IAAI,WAAW;QACnC,IAAI,EAAE,UAAU,IAAI,WAAW;KAChC,CAAC,CAAC;IAEH,iEAAiE;IACjE,MAAM,KAAK,GAAG,iBAAiB,IAAI,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAE1D,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE;YAC9C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,SAAS;SACtD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE;YACvD,KAAK;YACL,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,MAAM,EAAE,YAAY,IAAI,WAAW;YACnC,IAAI,EAAE,UAAU,IAAI,WAAW;YAC/B,cAAc,EAAE,MAAM,CAAC,kBAAkB;SAC1C,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Server setup and initialization
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { HaClient } from './haClient.js';
+export declare function createMcpServer(client: HaClient): Promise<Server>;
+export declare function startStdioServer(client: HaClient): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,wBAAsB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBvE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE"}

package/dist/server.js

@@ -0,0 +1,30 @@
+/**
+ * MCP Server setup and initialization
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerAllTools } from './tools/registry.js';
+import { logger } from './utils/logger.js';
+export async function createMcpServer(client) {
+    logger.info('Creating MCP server');
+    const server = new Server({
+        name: 'ha-mcp',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register all tools
+    registerAllTools(server, client);
+    logger.info('MCP server created with 5 tools registered');
+    return server;
+}
+export async function startStdioServer(client) {
+    logger.info('Starting MCP server with stdio transport');
+    const server = await createMcpServer(client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('MCP server connected and ready');
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAgB;IACpD,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,qBAAqB;IACrB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAE1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAgB;IACrD,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC"}

package/dist/tools/callService.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Call Service Tool
+ * Calls a Home Assistant service
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { HaClient } from '../haClient/index.js';
+export declare function registerCallServiceTool(server: Server, client: HaClient): void;
+//# sourceMappingURL=callService.d.ts.map

package/dist/tools/callService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callService.d.ts","sourceRoot":"","sources":["../../src/tools/callService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIrD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAmG9E"}

package/dist/tools/callService.js

@@ -0,0 +1,100 @@
+/**
+ * Call Service Tool
+ * Calls a Home Assistant service
+ */
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { logger } from '../utils/logger.js';
+export function registerCallServiceTool(server, client) {
+    logger.debug('Registering callService tool');
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'callService',
+                    description: 'Call a Home Assistant service (e.g., turn on a light, set temperature).',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            domain: {
+                                type: 'string',
+                                description: 'Service domain (e.g., "light", "switch", "climate", "notify")',
+                            },
+                            service: {
+                                type: 'string',
+                                description: 'Service name (e.g., "turn_on", "turn_off", "set_temperature")',
+                            },
+                            service_data: {
+                                type: 'object',
+                                description: 'Optional service data (e.g., {"brightness": 255})',
+                            },
+                            target: {
+                                type: 'object',
+                                description: 'Optional target (entity_id, device_id, or area_id)',
+                                properties: {
+                                    entity_id: {
+                                        type: ['string', 'array'],
+                                        description: 'Entity ID or array of entity IDs',
+                                    },
+                                },
+                            },
+                        },
+                        required: ['domain', 'service'],
+                    },
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        if (request.params.name !== 'callService') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'Unknown tool' }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const args = request.params.arguments;
+            if (!args.domain || !args.service) {
+                throw new Error('domain and service are required');
+            }
+            logger.info('Executing callService tool', {
+                domain: args.domain,
+                service: args.service,
+            });
+            const result = await client.callService(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            context: result.context,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Failed to call service', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to call service',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=callService.js.map

package/dist/tools/callService.js.map

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

package/dist/tools/getClient.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Client Tool
+ * Get details for a specific client by MAC address
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { OmadaClient } from '../omadaClient.js';
+export declare function registerGetClientTool(server: Server, client: OmadaClient): void;
+//# sourceMappingURL=getClient.d.ts.map

package/dist/tools/getClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClient.d.ts","sourceRoot":"","sources":["../../src/tools/getClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAgG/E"}