@switchbot/openapi-cli 1.1.0 → 1.3.0

package/dist/commands/mcp.js

@@ -0,0 +1,386 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { z } from 'zod';
+import { handleError, isJsonMode } from '../utils/output.js';
+import { fetchDeviceList, fetchDeviceStatus, executeCommand, describeDevice, validateCommand, isDestructiveCommand, getDestructiveReason, searchCatalog, DeviceNotFoundError, toMcpDescribeShape, toMcpDeviceListShape, toMcpIrDeviceShape, } from '../lib/devices.js';
+import { fetchScenes, executeScene } from '../lib/scenes.js';
+import { findCatalogEntry } from '../devices/catalog.js';
+import { getCachedDevice } from '../devices/cache.js';
+function mcpError(kind, code, message, options) {
+    const obj = { code, kind, message };
+    if (options?.hint)
+        obj.hint = options.hint;
+    if (options?.retryable)
+        obj.retryable = true;
+    if (options?.context)
+        obj.context = options.context;
+    return {
+        isError: true,
+        content: [{ type: 'text', text: JSON.stringify({ error: obj }, null, 2) }],
+    };
+}
+export function createSwitchBotMcpServer() {
+    const server = new McpServer({
+        name: 'switchbot',
+        version: '1.4.0',
+    }, {
+        capabilities: { tools: {} },
+        instructions: `SwitchBot is an IoT smart home brand by Wonderlabs, Inc. This MCP server controls physical devices \
+(Bot, Curtain, Smart Lock, Color Bulb, Meter, Plug, Robot Vacuum, etc.) and IR remotes \
+(TV, AC, Set Top Box, etc.) via the SwitchBot Cloud API v1.1.
+
+Device categories:
+- physical: Wi-Fi/BLE devices; BLE-only ones require a Hub (check enableCloudService)
+- ir: IR remotes learned by a Hub; no status channel, commands only
+
+Key constraints:
+- API quota: 10,000 requests/day per account — use cache, avoid polling
+- Destructive commands (unlock, garage open, keypad createKey/deleteKey) require confirm:true
+- Devices without enableCloudService cannot receive commands via API
+
+Recommended bootstrap sequence:
+1. list_devices → get deviceIds and categories
+2. search_catalog or describe_device → confirm supported commands offline/online
+3. send_command (with confirm:true for destructive commands)
+
+API docs: https://github.com/OpenWonderLabs/SwitchBotAPI`,
+    });
+    // ---- list_devices ---------------------------------------------------------
+    server.registerTool('list_devices', {
+        title: 'List all devices on the account',
+        description: 'Fetch the inventory of physical devices and IR remotes on this SwitchBot account. Refreshes the local cache.',
+        inputSchema: {},
+        outputSchema: {
+            deviceList: z.array(z.object({
+                deviceId: z.string(),
+                deviceName: z.string(),
+                deviceType: z.string().optional(),
+                enableCloudService: z.boolean(),
+                hubDeviceId: z.string(),
+                roomID: z.string().optional(),
+                roomName: z.string().nullable().optional(),
+                familyName: z.string().optional(),
+                controlType: z.string().optional(),
+            }).passthrough()).describe('Physical SwitchBot devices'),
+            infraredRemoteList: z.array(z.object({
+                deviceId: z.string(),
+                deviceName: z.string(),
+                remoteType: z.string(),
+                hubDeviceId: z.string(),
+                controlType: z.string().optional(),
+            }).passthrough()).describe('IR remote devices'),
+        },
+    }, async () => {
+        const body = await fetchDeviceList();
+        return {
+            content: [{ type: 'text', text: JSON.stringify(body, null, 2) }],
+            structuredContent: {
+                deviceList: body.deviceList.map(toMcpDeviceListShape),
+                infraredRemoteList: body.infraredRemoteList.map(toMcpIrDeviceShape),
+            },
+        };
+    });
+    // ---- get_device_status ----------------------------------------------------
+    server.registerTool('get_device_status', {
+        title: 'Get live status for a device',
+        description: 'Query the real-time status payload for a physical device. IR remotes have no status channel and will error.',
+        inputSchema: {
+            deviceId: z.string().describe('Device ID from list_devices'),
+        },
+        outputSchema: {
+            status: z.object({
+                deviceId: z.string().optional(),
+                deviceType: z.string().optional(),
+                hubDeviceId: z.string().optional(),
+                connectionStatus: z.string().optional(),
+            }).passthrough().describe('Live device status (deviceId + deviceType + device-specific fields)'),
+        },
+    }, async ({ deviceId }) => {
+        const body = await fetchDeviceStatus(deviceId);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(body, null, 2) }],
+            structuredContent: { status: body },
+        };
+    });
+    // ---- send_command ---------------------------------------------------------
+    server.registerTool('send_command', {
+        title: 'Send a control command to a device',
+        description: 'Send a control command (turnOn, setColor, startClean, unlock, ...) to a device. Destructive commands (unlock, garage open, keypad createKey) require confirm:true; otherwise they are rejected.',
+        inputSchema: {
+            deviceId: z.string().describe('Device ID from list_devices'),
+            command: z.string().describe('Command name, case-sensitive (e.g. turnOn, setColor, unlock)'),
+            parameter: z
+                .union([z.string(), z.number(), z.boolean(), z.record(z.string(), z.unknown()), z.array(z.unknown())])
+                .optional()
+                .describe('Command parameter. Omit for no-arg commands.'),
+            commandType: z
+                .enum(['command', 'customize'])
+                .optional()
+                .default('command')
+                .describe('"command" for built-in commands; "customize" for user-defined IR buttons'),
+            confirm: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Required true for destructive commands (unlock, garage open, createKey, ...)'),
+        },
+        outputSchema: {
+            ok: z.literal(true),
+            command: z.string(),
+            deviceId: z.string(),
+            result: z.unknown().describe('API response body from SwitchBot'),
+        },
+    }, async ({ deviceId, command, parameter, commandType, confirm }) => {
+        const effectiveType = commandType ?? 'command';
+        // Resolve the device's catalog type via cache or a fresh lookup so we
+        // can evaluate destructive/validation without an extra round-trip if
+        // the cache is warm.
+        let typeName = getCachedDevice(deviceId)?.type;
+        if (!typeName) {
+            const body = await fetchDeviceList();
+            const physical = body.deviceList.find((d) => d.deviceId === deviceId);
+            const ir = body.infraredRemoteList.find((d) => d.deviceId === deviceId);
+            if (!physical && !ir) {
+                return mcpError('runtime', 152, `Device not found: ${deviceId}`, {
+                    hint: "Check the deviceId with 'switchbot devices list' (IDs are case-sensitive).",
+                });
+            }
+            typeName = physical ? physical.deviceType : ir.remoteType;
+        }
+        if (isDestructiveCommand(typeName, command, effectiveType) && !confirm) {
+            const reason = getDestructiveReason(typeName, command, effectiveType);
+            const entry = typeName ? findCatalogEntry(typeName) : null;
+            const spec = entry && !Array.isArray(entry)
+                ? entry.commands.find((c) => c.command === command)
+                : undefined;
+            const hint = reason
+                ? `Re-issue with confirm:true after confirming with the user. Reason: ${reason}`
+                : 'Re-issue the call with confirm:true to proceed.';
+            return mcpError('guard', 3, `Command "${command}" on device type "${typeName}" is destructive and requires confirm:true.`, {
+                hint,
+                context: {
+                    command,
+                    deviceType: typeName,
+                    description: spec?.description ?? null,
+                    ...(reason ? { destructiveReason: reason } : {}),
+                },
+            });
+        }
+        // stringifiedParam is what validateCommand expects to decide
+        // "no-parameter" conflicts — mirror the CLI behavior.
+        const stringifiedParam = parameter === undefined ? undefined : typeof parameter === 'string' ? parameter : JSON.stringify(parameter);
+        const validation = validateCommand(deviceId, command, stringifiedParam, effectiveType);
+        if (!validation.ok) {
+            return mcpError('usage', 2, validation.error.message, { hint: validation.error.hint, context: { validationKind: validation.error.kind } });
+        }
+        const result = await executeCommand(deviceId, command, parameter, effectiveType);
+        const structured = { ok: true, command, deviceId, result };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(structured, null, 2) }],
+            structuredContent: structured,
+        };
+    });
+    // ---- run_scene ------------------------------------------------------------
+    server.registerTool('run_scene', {
+        title: 'Execute a manual scene',
+        description: 'Execute a manual SwitchBot scene by its sceneId (from list_scenes).',
+        inputSchema: {
+            sceneId: z.string().describe('Scene ID from list_scenes'),
+        },
+        outputSchema: {
+            ok: z.literal(true),
+            sceneId: z.string(),
+        },
+    }, async ({ sceneId }) => {
+        await executeScene(sceneId);
+        const structured = { ok: true, sceneId };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(structured, null, 2) }],
+            structuredContent: structured,
+        };
+    });
+    // ---- list_scenes (companion to run_scene) ---------------------------------
+    server.registerTool('list_scenes', {
+        title: 'List all manual scenes',
+        description: 'Fetch all manual scenes configured in the SwitchBot app.',
+        inputSchema: {},
+        outputSchema: {
+            scenes: z.array(z.object({ sceneId: z.string(), sceneName: z.string() })),
+        },
+    }, async () => {
+        const scenes = await fetchScenes();
+        return {
+            content: [{ type: 'text', text: JSON.stringify(scenes, null, 2) }],
+            structuredContent: { scenes },
+        };
+    });
+    // ---- search_catalog -------------------------------------------------------
+    server.registerTool('search_catalog', {
+        title: 'Search the offline device catalog',
+        description: 'Search the built-in device catalog by type name or alias. Returns matching entries with their commands, roles, destructive flags, and status fields. No API call.',
+        inputSchema: {
+            query: z.string().describe('Search query (matches type and aliases, case-insensitive). Use empty string to list all.'),
+            limit: z.number().int().min(1).max(100).optional().default(20).describe('Max entries returned (default 20)'),
+        },
+        outputSchema: {
+            results: z.array(z.object({
+                type: z.string(),
+                category: z.enum(['physical', 'ir']),
+                commands: z.array(z.object({
+                    command: z.string(),
+                    parameter: z.string(),
+                    description: z.string(),
+                    commandType: z.enum(['command', 'customize']).optional(),
+                    idempotent: z.boolean().optional(),
+                    destructive: z.boolean().optional(),
+                }).passthrough()),
+                aliases: z.array(z.string()).optional(),
+                statusFields: z.array(z.string()).optional(),
+                role: z.string().optional(),
+                readOnly: z.boolean().optional(),
+            }).passthrough()).describe('Matching catalog entries'),
+            total: z.number().int().describe('Number of entries returned'),
+        },
+    }, async ({ query, limit }) => {
+        const hits = searchCatalog(query, limit);
+        const structured = { results: hits, total: hits.length };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(hits, null, 2) }],
+            structuredContent: structured,
+        };
+    });
+    // ---- describe_device ------------------------------------------------------
+    server.registerTool('describe_device', {
+        title: 'Describe a specific device',
+        description: 'Resolve a deviceId to its metadata + catalog entry + suggested safe actions. Pass live:true to also fetch real-time status values.',
+        inputSchema: {
+            deviceId: z.string().describe('Device ID from list_devices'),
+            live: z.boolean().optional().default(false).describe('Also fetch live /status values (costs 1 extra API call)'),
+        },
+        outputSchema: {
+            device: z.object({
+                device: z.object({ deviceId: z.string(), deviceName: z.string() }).passthrough(),
+                isPhysical: z.boolean(),
+                typeName: z.string(),
+                controlType: z.string().nullable(),
+                source: z.enum(['catalog', 'live', 'catalog+live', 'none']),
+                capabilities: z.unknown().nullable(),
+                suggestedActions: z.array(z.object({
+                    command: z.string(),
+                    parameter: z.string().optional(),
+                    description: z.string(),
+                })).optional(),
+                inheritedLocation: z.object({
+                    family: z.string().optional(),
+                    room: z.string().optional(),
+                }).optional(),
+            }).passthrough().describe('Device metadata, catalog entry, capabilities, and optional live status'),
+        },
+    }, async ({ deviceId, live }) => {
+        try {
+            const result = await describeDevice(deviceId, { live });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                structuredContent: { device: toMcpDescribeShape(result) },
+            };
+        }
+        catch (err) {
+            if (err instanceof DeviceNotFoundError) {
+                return mcpError('runtime', 152, err.message, {
+                    hint: "Check the deviceId with 'switchbot devices list' (IDs are case-sensitive).",
+                    context: { deviceId },
+                });
+            }
+            throw err;
+        }
+    });
+    return server;
+}
+export function registerMcpCommand(program) {
+    const mcp = program
+        .command('mcp')
+        .description('Run as a Model Context Protocol server so AI agents can call SwitchBot tools')
+        .addHelpText('after', `
+The MCP server exposes seven tools over stdio:
+  - list_devices          fetch all physical + IR devices
+  - get_device_status     live status for a physical device
+  - send_command          control a device (destructive commands need confirm:true)
+  - list_scenes           list all manual scenes
+  - run_scene             execute a manual scene
+  - search_catalog        offline catalog search by type/alias
+  - describe_device       metadata + commands + (optionally) live status for one device
+
+Example Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
+
+  {
+    "mcpServers": {
+      "switchbot": {
+        "command": "switchbot",
+        "args": ["mcp", "serve"],
+        "env": {
+          "SWITCHBOT_TOKEN": "...",
+          "SWITCHBOT_SECRET": "..."
+        }
+      }
+    }
+  }
+
+Inspect locally:
+  $ npx @modelcontextprotocol/inspector switchbot mcp serve
+`);
+    mcp
+        .command('serve')
+        .description('Start the MCP server on stdio (default) or HTTP (--port)')
+        .option('--port <n>', 'Listen on HTTP instead of stdio (Streamable HTTP transport)')
+        .action(async (options) => {
+        try {
+            if (options.port) {
+                const port = Number(options.port);
+                if (!Number.isFinite(port) || port < 1 || port > 65535) {
+                    const msg = `Invalid --port "${options.port}". Must be 1-65535.`;
+                    if (isJsonMode()) {
+                        console.error(JSON.stringify({ error: { code: 2, kind: 'usage', message: msg } }));
+                    }
+                    else {
+                        console.error(msg);
+                    }
+                    process.exit(2);
+                }
+                const { createServer } = await import('node:http');
+                const httpServer = createServer(async (req, res) => {
+                    // Stateless mode: fresh transport+server per request (SDK requirement).
+                    const reqTransport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+                    const reqServer = createSwitchBotMcpServer();
+                    // Register cleanup before any async work so it fires on both normal
+                    // close and error-path close (after the 500 response ends).
+                    res.on('close', () => {
+                        reqTransport.close();
+                        reqServer.close();
+                    });
+                    try {
+                        await reqServer.connect(reqTransport);
+                        await reqTransport.handleRequest(req, res);
+                    }
+                    catch (err) {
+                        if (!res.headersSent) {
+                            res.writeHead(500, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ jsonrpc: '2.0', error: { code: -32603, message: 'Internal server error' }, id: null }));
+                        }
+                    }
+                });
+                httpServer.listen(port, () => {
+                    console.error(`SwitchBot MCP server listening on http://localhost:${port}/mcp`);
+                });
+                return;
+            }
+            const server = createSwitchBotMcpServer();
+            const transport = new StdioServerTransport();
+            await server.connect(transport);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/plan.d.ts

@@ -0,0 +1,38 @@
+import { Command } from 'commander';
+export interface PlanCommandStep {
+    type: 'command';
+    deviceId?: string;
+    deviceName?: string;
+    command: string;
+    parameter?: unknown;
+    commandType?: 'command' | 'customize';
+    note?: string;
+}
+export interface PlanSceneStep {
+    type: 'scene';
+    sceneId: string;
+    note?: string;
+}
+export interface PlanWaitStep {
+    type: 'wait';
+    ms: number;
+    note?: string;
+}
+export type PlanStep = PlanCommandStep | PlanSceneStep | PlanWaitStep;
+export interface Plan {
+    version: '1.0';
+    description?: string;
+    steps: PlanStep[];
+}
+export interface PlanValidationIssue {
+    path: string;
+    message: string;
+}
+export declare function validatePlan(raw: unknown): {
+    ok: true;
+    plan: Plan;
+} | {
+    ok: false;
+    issues: PlanValidationIssue[];
+};
+export declare function registerPlanCommand(program: Command): void;