@kunobi/mcp 0.0.2 → 0.0.3

package/dist/discovery.d.ts

@@ -2,14 +2,23 @@ export type KunobiState = {
     status: 'not_installed';
 } | {
     status: 'installed_not_running';
+    variants: string[];
 } | {
     status: 'running_mcp_unreachable';
     pid: number;
+    variants: string[];
 } | {
     status: 'connected';
     pid: number;
     tools: string[];
+    variants: string[];
 };
+export declare function launchHint(): string;
+export declare function getLaunchCommand(variant: string): {
+    command: string;
+    args: string[];
+} | null;
 export declare function getMcpUrl(): string;
+export declare function findKunobiVariants(): string[];
 export declare function detectKunobi(): Promise<KunobiState>;
 //# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,GAC3B;IAAE,MAAM,EAAE,uBAAuB,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,yBAAyB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAY1D,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAuHD,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CA6BzD"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,GAC3B;IAAE,MAAM,EAAE,uBAAuB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,yBAAyB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACtE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAU9E,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CA+B5C;AAID,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAgDD,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAgD7C;AAiDD,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAgCzD"}

package/dist/discovery.js

@@ -2,7 +2,46 @@ import { existsSync } from 'node:fs';
 import { readdir, readFile } from 'node:fs/promises';
 import { platform, homedir } from 'node:os';
 import { join } from 'node:path';
+import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
 
+function launchHint() {
+    const os = platform();
+    if (os === 'darwin')
+        return 'Launch it from your Applications folder.';
+    if (os === 'win32')
+        return 'Launch it from the Start menu.';
+    return 'Launch Kunobi from your app launcher or run it from the terminal.';
+}
+function getLaunchCommand(variant) {
+    const os = platform();
+    if (os === 'darwin') {
+        return { command: 'open', args: ['-a', variant] };
+    }
+    if (os === 'linux') {
+        const bin = variant.toLowerCase().replace(/\s+/g, '-');
+        const dirs = [
+            '/usr/bin',
+            '/usr/local/bin',
+            join(homedir(), '.local', 'bin'),
+        ];
+        for (const dir of dirs) {
+            const p = join(dir, bin);
+            if (existsSync(p))
+                return { command: p, args: [] };
+        }
+        return null;
+    }
+    if (os === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA;
+        if (localAppData) {
+            const exe = join(localAppData, variant, `${variant}.exe`);
+            if (existsSync(exe))
+                return { command: exe, args: [] };
+        }
+        return null;
+    }
+    return null;
+}
 const DEFAULT_MCP_URL = 'http://127.0.0.1:3030/mcp';
 function getMcpUrl() {
     return process.env.KUNOBI_MCP_URL || DEFAULT_MCP_URL;
@@ -45,28 +84,54 @@ async function findKunobiLockFile() {
     }
     return null;
 }
-function isKunobiInstalled() {
+const KUNOBI_VARIANTS = ['', ' Dev', ' Unstable', ' E2E', ' Local'];
+function variantLabel(suffix) {
+    return suffix ? `Kunobi${suffix}` : 'Kunobi';
+}
+function findKunobiVariants() {
     const os = platform();
+    const found = [];
     if (os === 'darwin') {
-        return (existsSync('/Applications/Kunobi.app') ||
-            existsSync(join(homedir(), 'Applications', 'Kunobi.app')));
+        const dirs = ['/Applications', join(homedir(), 'Applications')];
+        for (const v of KUNOBI_VARIANTS) {
+            if (dirs.some((dir) => existsSync(join(dir, `Kunobi${v}.app`)))) {
+                found.push(variantLabel(v));
+            }
+        }
+        return found;
     }
     if (os === 'linux') {
-        const paths = [
-            '/usr/bin/kunobi',
-            '/usr/local/bin/kunobi',
-            join(homedir(), '.local', 'bin', 'kunobi'),
+        const dirs = [
+            '/usr/bin',
+            '/usr/local/bin',
+            join(homedir(), '.local', 'bin'),
+        ];
+        const linuxVariants = [
+            ['kunobi', 'Kunobi'],
+            ['kunobi-dev', 'Kunobi Dev'],
+            ['kunobi-unstable', 'Kunobi Unstable'],
+            ['kunobi-e2e', 'Kunobi E2E'],
+            ['kunobi-local', 'Kunobi Local'],
         ];
-        return paths.some((p) => existsSync(p));
+        for (const [bin, label] of linuxVariants) {
+            if (dirs.some((dir) => existsSync(join(dir, bin)))) {
+                found.push(label);
+            }
+        }
+        return found;
     }
-    // Windows — check common install location
     if (os === 'win32') {
         const localAppData = process.env.LOCALAPPDATA;
         if (localAppData) {
-            return existsSync(join(localAppData, 'Kunobi', 'Kunobi.exe'));
+            for (const v of KUNOBI_VARIANTS) {
+                if (existsSync(join(localAppData, `Kunobi${v}`, `Kunobi${v}.exe`))) {
+                    found.push(variantLabel(v));
+                }
+            }
         }
+        return found;
     }
-    return false;
+    return found;
 }
 async function probeMcpServer(url) {
     try {
@@ -78,7 +143,7 @@ async function probeMcpServer(url) {
                 id: 1,
                 method: 'initialize',
                 params: {
-                    protocolVersion: '2025-03-26',
+                    protocolVersion: LATEST_PROTOCOL_VERSION,
                     capabilities: {},
                     clientInfo: { name: 'kunobi-mcp-probe', version: '0.0.1' },
                 },
@@ -116,6 +181,7 @@ async function probeMcpServer(url) {
 async function detectKunobi() {
     const lockFile = await findKunobiLockFile();
     const mcpUrl = getMcpUrl();
+    const variants = findKunobiVariants();
     // Check if MCP server is reachable
     const tools = await probeMcpServer(mcpUrl);
     if (tools !== null) {
@@ -123,6 +189,7 @@ async function detectKunobi() {
             status: 'connected',
             pid: lockFile?.pid ?? 0,
             tools,
+            variants,
         };
     }
     // MCP not reachable — check if running via lock file
@@ -130,14 +197,15 @@ async function detectKunobi() {
         return {
             status: 'running_mcp_unreachable',
             pid: lockFile.pid,
+            variants,
         };
     }
     // Not running — check if installed
-    if (isKunobiInstalled()) {
-        return { status: 'installed_not_running' };
+    if (variants.length > 0) {
+        return { status: 'installed_not_running', variants };
     }
     return { status: 'not_installed' };
 }
 
-export { detectKunobi, getMcpUrl };
+export { detectKunobi, findKunobiVariants, getLaunchCommand, getMcpUrl, launchHint };
 //# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/server.js

@@ -1,12 +1,121 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
 import { McpBundler } from '@kunobi/mcp-bundler';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { getMcpUrl } from './discovery.js';
+import { detectKunobi, launchHint, getMcpUrl } from './discovery.js';
+import { registerLaunchTool } from './tools/launch.js';
 import { registerStatusTool } from './tools/status.js';
 
-const server = new McpServer({ name: 'kunobi', version: '0.0.1' }, { capabilities: { tools: { listChanged: true } } });
+const require$1 = createRequire(import.meta.url);
+const { version } = require$1('../package.json');
+const arg = process.argv[2];
+if (arg === '--help' || arg === '-h') {
+    console.log(`Kunobi MCP server v${version} — connects AI assistants to the Kunobi desktop app.
+
+Usage (in Claude settings):
+  {
+    "mcpServers": {
+      "kunobi": {
+        "command": "npx",
+        "args": ["@kunobi/mcp"]
+      }
+    }
+  }
+
+Options:
+  --help, -h       Show this help message
+  --version, -v    Show version number
+
+Environment:
+  KUNOBI_MCP_URL   Override Kunobi's MCP endpoint (default: http://127.0.0.1:3030/mcp)`);
+    process.exit(0);
+}
+if (arg === '--version' || arg === '-v') {
+    console.log(version);
+    process.exit(0);
+}
+const server = new McpServer({ name: 'kunobi', version }, { capabilities: { tools: { listChanged: true }, logging: {} } });
 registerStatusTool(server);
+registerLaunchTool(server);
+// Resource: passive way for the LLM to check Kunobi state
+server.registerResource('kunobi_status', 'kunobi://status', {
+    description: 'Current Kunobi connection state and available tools',
+    mimeType: 'application/json',
+}, async () => {
+    const state = await detectKunobi();
+    return {
+        contents: [
+            {
+                uri: 'kunobi://status',
+                mimeType: 'application/json',
+                text: JSON.stringify(state, null, 2),
+            },
+        ],
+    };
+});
+// Prompt: guide user through Kunobi setup
+server.registerPrompt('kunobi-setup', {
+    description: 'Check Kunobi status and provide setup instructions',
+}, async () => {
+    const state = await detectKunobi();
+    let instructions;
+    switch (state.status) {
+        case 'not_installed':
+            instructions =
+                'Kunobi is not installed. Download it from https://kunobi.ninja/downloads and install it on your system.';
+            break;
+        case 'installed_not_running':
+            instructions = `Kunobi is installed but not running (found: ${state.variants.join(', ')}). ${launchHint()}`;
+            break;
+        case 'running_mcp_unreachable':
+            instructions = `Kunobi is running (PID ${state.pid}) but the MCP endpoint is not reachable. Open Kunobi Settings and make sure MCP is enabled.`;
+            break;
+        case 'connected':
+            instructions = `Kunobi is connected and ready. ${state.tools.length} tools available: ${state.tools.join(', ')}.${state.variants.length > 0 ? ` Installed variants: ${state.variants.join(', ')}.` : ''}`;
+            break;
+    }
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: { type: 'text', text: instructions },
+            },
+        ],
+    };
+});
+// Prompt: diagnose Kunobi connection issues
+server.registerPrompt('kunobi-doctor', {
+    description: 'Diagnose why Kunobi tools are unavailable and suggest fixes',
+}, async () => {
+    const state = await detectKunobi();
+    const steps = [];
+    switch (state.status) {
+        case 'not_installed':
+            steps.push('Kunobi is not installed on this system.', '1. Download Kunobi from https://kunobi.ninja/downloads', '2. Install and launch the application', '3. Enable MCP in Kunobi Settings');
+            break;
+        case 'installed_not_running':
+            steps.push(`Kunobi is installed but not running. Found variants: ${state.variants.join(', ')}.`, `1. ${launchHint()}`, '2. Wait a few seconds for MCP to initialize', '3. Tools will appear automatically once connected');
+            break;
+        case 'running_mcp_unreachable':
+            steps.push(`Kunobi is running (PID ${state.pid}) but the MCP endpoint is unreachable.`, '1. Open Kunobi Settings and verify MCP is enabled', `2. Check that the MCP endpoint is accessible at ${getMcpUrl()}`, '3. Try restarting Kunobi');
+            break;
+        case 'connected':
+            steps.push('No issues detected — Kunobi is connected and working.', `${state.tools.length} tools available: ${state.tools.join(', ')}`);
+            break;
+    }
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: { type: 'text', text: steps.join('\n') },
+            },
+        ],
+    };
+});
+const CONNECTION_CHECK_AFTER = 6; // Check installation after ~30s (6 × 5s)
+let failCount = 0;
+let checkDone = false;
 const bundler = new McpBundler({
     name: 'kunobi',
     url: getMcpUrl(),
@@ -15,9 +124,37 @@ const bundler = new McpBundler({
         intervalMs: 5_000,
         maxRetries: Number.POSITIVE_INFINITY,
     },
-    logger: (level, msg, data) => {
+    logger: (level) => {
         if (level === 'error') {
-            console.error(`[kunobi-mcp] ${msg}`, data ?? '');
+            failCount++;
+            if (failCount >= CONNECTION_CHECK_AFTER && !checkDone) {
+                checkDone = true;
+                detectKunobi().then((state) => {
+                    let msg;
+                    switch (state.status) {
+                        case 'not_installed':
+                            msg =
+                                'Kunobi is not installed. Download it from https://kunobi.ninja/downloads';
+                            break;
+                        case 'installed_not_running':
+                            msg = `Kunobi is installed but not running (found: ${state.variants.join(', ')}). ${launchHint()}`;
+                            break;
+                        case 'running_mcp_unreachable':
+                            msg =
+                                'Kunobi is running but MCP is unreachable. Check that MCP is enabled in Kunobi Settings.';
+                            break;
+                    }
+                    if (msg) {
+                        server.server
+                            .sendLoggingMessage({
+                            level: 'warning',
+                            logger: 'kunobi-mcp',
+                            data: msg,
+                        })
+                            .catch(() => { });
+                    }
+                });
+            }
         }
     },
 });
@@ -30,6 +167,8 @@ async function notifyToolsChanged() {
     }
 }
 bundler.on('connected', async () => {
+    failCount = 0;
+    checkDone = false;
     await bundler.registerTools(server);
     await notifyToolsChanged();
 });

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sources":["../src/server.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAQA,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,CACnD;AAED,kBAAkB,CAAC,MAAM,CAAC;AAE1B,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;AAC7B,IAAA,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,SAAS,EAAE;AAChB,IAAA,SAAS,EAAE;AACT,QAAA,OAAO,EAAE,IAAI;AACb,QAAA,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,MAAM,CAAC,iBAAiB;AACrC,KAAA;IACD,MAAM,EAAE,CAAC,KAAa,EAAE,GAAW,EAAE,IAAc,KAAI;AACrD,QAAA,IAAI,KAAK,KAAK,OAAO,EAAE;YACrB,OAAO,CAAC,KAAK,CAAC,CAAA,aAAA,EAAgB,GAAG,CAAA,CAAE,EAAE,IAAI,IAAI,EAAE,CAAC;QAClD;IACF,CAAC;AACF,CAAA,CAAC;AAEF,eAAe,kBAAkB,GAAA;AAC/B,IAAA,IAAI;AACF,QAAA,MAAM,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE;IAC3C;AAAE,IAAA,MAAM;;IAER;AACF;AAEA,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,YAAW;AACjC,IAAA,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,MAAM,kBAAkB,EAAE;AAC5B,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,YAAW;AACpC,IAAA,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;IAC/B,MAAM,kBAAkB,EAAE;AAC5B,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,YAAW;AACrC,IAAA,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;AAC/B,IAAA,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,MAAM,kBAAkB,EAAE;AAC5B,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;AAE/B;AACA,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,MAAK,EAAE,CAAC,CAAC"}
+{"version":3,"file":"server.js","sources":["../src/server.ts"],"sourcesContent":[null],"names":["require"],"mappings":"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"}

package/dist/tools/launch.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerLaunchTool(server: McpServer): void;
+//# sourceMappingURL=launch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/tools/launch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8E1D"}

package/dist/tools/launch.js

@@ -0,0 +1,73 @@
+import { spawn } from 'node:child_process';
+import { z } from 'zod';
+import { findKunobiVariants, getLaunchCommand } from '../discovery.js';
+
+function registerLaunchTool(server) {
+    server.registerTool('kunobi_launch', {
+        description: 'Launch the Kunobi desktop app. Optionally specify which variant to launch (e.g. "Kunobi Dev"). If omitted, launches the first installed variant.',
+        inputSchema: {
+            variant: z
+                .string()
+                .optional()
+                .describe('Which Kunobi variant to launch, e.g. "Kunobi", "Kunobi Dev"'),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ variant }) => {
+        const variants = findKunobiVariants();
+        if (variants.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Kunobi is not installed. Download it from https://kunobi.ninja/downloads',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const target = variant ?? variants[0];
+        if (!variants.includes(target)) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Variant "${target}" is not installed. Available: ${variants.join(', ')}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const launch = getLaunchCommand(target);
+        if (!launch) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Could not determine how to launch "${target}" on this platform.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const child = spawn(launch.command, launch.args, {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Launching ${target}. It may take a few seconds for MCP to become available.`,
+                },
+            ],
+        };
+    });
+}
+
+export { registerLaunchTool };
+//# sourceMappingURL=launch.js.map

package/dist/tools/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sources":["../../src/tools/launch.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKM,SAAU,kBAAkB,CAAC,MAAiB,EAAA;AAClD,IAAA,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;AACE,QAAA,WAAW,EACT,kJAAkJ;AACpJ,QAAA,WAAW,EAAE;AACX,YAAA,OAAO,EAAE;AACN,iBAAA,MAAM;AACN,iBAAA,QAAQ;iBACR,QAAQ,CACP,6DAA6D,CAC9D;AACJ,SAAA;AACD,QAAA,WAAW,EAAE;AACX,YAAA,YAAY,EAAE,KAAK;AACnB,YAAA,eAAe,EAAE,KAAK;AACtB,YAAA,aAAa,EAAE,KAAK;AACrB,SAAA;AACF,KAAA,EACD,OAAO,EAAE,OAAO,EAAE,KAAI;AACpB,QAAA,MAAM,QAAQ,GAAG,kBAAkB,EAAE;AAErC,QAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;YACzB,OAAO;AACL,gBAAA,OAAO,EAAE;AACP,oBAAA;AACE,wBAAA,IAAI,EAAE,MAAe;AACrB,wBAAA,IAAI,EAAE,0EAA0E;AACjF,qBAAA;AACF,iBAAA;AACD,gBAAA,OAAO,EAAE,IAAI;aACd;QACH;QAEA,MAAM,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC;QAErC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;YAC9B,OAAO;AACL,gBAAA,OAAO,EAAE;AACP,oBAAA;AACE,wBAAA,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,CAAA,SAAA,EAAY,MAAM,CAAA,+BAAA,EAAkC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AAChF,qBAAA;AACF,iBAAA;AACD,gBAAA,OAAO,EAAE,IAAI;aACd;QACH;AAEA,QAAA,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE;YACX,OAAO;AACL,gBAAA,OAAO,EAAE;AACP,oBAAA;AACE,wBAAA,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,CAAA,mCAAA,EAAsC,MAAM,CAAA,mBAAA,CAAqB;AACxE,qBAAA;AACF,iBAAA;AACD,gBAAA,OAAO,EAAE,IAAI;aACd;QACH;QAEA,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;AAC/C,YAAA,QAAQ,EAAE,IAAI;AACd,YAAA,KAAK,EAAE,QAAQ;AAChB,SAAA,CAAC;QACF,KAAK,CAAC,KAAK,EAAE;QAEb,OAAO;AACL,YAAA,OAAO,EAAE;AACP,gBAAA;AACE,oBAAA,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,CAAA,UAAA,EAAa,MAAM,CAAA,wDAAA,CAA0D;AACpF,iBAAA;AACF,aAAA;SACF;AACH,IAAA,CAAC,CACF;AACH;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAc1D"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuCzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmB1D"}

package/dist/tools/status.js

@@ -1,4 +1,4 @@
-import { detectKunobi } from '../discovery.js';
+import { detectKunobi, launchHint } from '../discovery.js';
 
 function formatStatus(state) {
     switch (state.status) {
@@ -6,13 +6,13 @@ function formatStatus(state) {
             return [
                 'Kunobi is not installed.',
                 '',
-                'Download from: https://kunobi.ninja',
+                'Download from: https://kunobi.ninja/downloads',
             ].join('\n');
         case 'installed_not_running':
             return [
-                'Kunobi is installed but not running.',
+                `Kunobi is installed but not running. Found: ${state.variants.join(', ')}.`,
                 '',
-                'Launch it from your Applications folder.',
+                launchHint(),
             ].join('\n');
         case 'running_mcp_unreachable':
             return [
@@ -20,16 +20,26 @@ function formatStatus(state) {
                 '',
                 'Make sure MCP is enabled in Kunobi Settings.',
             ].join('\n');
-        case 'connected':
-            return [
+        case 'connected': {
+            const lines = [
                 `Connected to Kunobi${state.pid ? ` (PID ${state.pid})` : ''}.`,
                 `${state.tools.length} tools available: ${state.tools.join(', ')}`,
-            ].join('\n');
+            ];
+            if (state.variants.length > 0) {
+                lines.push(`Installed variants: ${state.variants.join(', ')}`);
+            }
+            return lines.join('\n');
+        }
     }
 }
 function registerStatusTool(server) {
     server.registerTool('kunobi_status', {
         description: 'Check the connection status of Kunobi desktop app. Returns whether Kunobi is installed, running, and what tools are available.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     }, async () => {
         const state = await detectKunobi();
         return {

package/dist/tools/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sources":["../../src/tools/status.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA,SAAS,YAAY,CAAC,KAAkB,EAAA;AACtC,IAAA,QAAQ,KAAK,CAAC,MAAM;AAClB,QAAA,KAAK,eAAe;YAClB,OAAO;gBACL,0BAA0B;gBAC1B,EAAE;gBACF,qCAAqC;AACtC,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;AAEd,QAAA,KAAK,uBAAuB;YAC1B,OAAO;gBACL,sCAAsC;gBACtC,EAAE;gBACF,0CAA0C;AAC3C,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;AAEd,QAAA,KAAK,yBAAyB;YAC5B,OAAO;gBACL,CAAA,uBAAA,EAA0B,KAAK,CAAC,GAAG,CAAA,kCAAA,CAAoC;gBACvE,EAAE;gBACF,8CAA8C;AAC/C,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;AAEd,QAAA,KAAK,WAAW;YACd,OAAO;AACL,gBAAA,CAAA,mBAAA,EAAsB,KAAK,CAAC,GAAG,GAAG,CAAA,MAAA,EAAS,KAAK,CAAC,GAAG,CAAA,CAAA,CAAG,GAAG,EAAE,CAAA,CAAA,CAAG;AAC/D,gBAAA,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA,kBAAA,EAAqB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AACnE,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;;AAElB;AAEM,SAAU,kBAAkB,CAAC,MAAiB,EAAA;AAClD,IAAA,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;AACE,QAAA,WAAW,EACT,gIAAgI;KACnI,EACD,YAAW;AACT,QAAA,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE;QAClC,OAAO;AACL,YAAA,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;SAChE;AACH,IAAA,CAAC,CACF;AACH;;;;"}
+{"version":3,"file":"status.js","sources":["../../src/tools/status.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA,SAAS,YAAY,CAAC,KAAkB,EAAA;AACtC,IAAA,QAAQ,KAAK,CAAC,MAAM;AAClB,QAAA,KAAK,eAAe;YAClB,OAAO;gBACL,0BAA0B;gBAC1B,EAAE;gBACF,+CAA+C;AAChD,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;AAEd,QAAA,KAAK,uBAAuB;YAC1B,OAAO;gBACL,CAAA,4CAAA,EAA+C,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAA,CAAG;gBAC3E,EAAE;AACF,gBAAA,UAAU,EAAE;AACb,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;AAEd,QAAA,KAAK,yBAAyB;YAC5B,OAAO;gBACL,CAAA,uBAAA,EAA0B,KAAK,CAAC,GAAG,CAAA,kCAAA,CAAoC;gBACvE,EAAE;gBACF,8CAA8C;AAC/C,aAAA,CAAC,IAAI,CAAC,IAAI,CAAC;QAEd,KAAK,WAAW,EAAE;AAChB,YAAA,MAAM,KAAK,GAAG;AACZ,gBAAA,CAAA,mBAAA,EAAsB,KAAK,CAAC,GAAG,GAAG,CAAA,MAAA,EAAS,KAAK,CAAC,GAAG,CAAA,CAAA,CAAG,GAAG,EAAE,CAAA,CAAA,CAAG;AAC/D,gBAAA,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA,kBAAA,EAAqB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;aACnE;YACD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AAC7B,gBAAA,KAAK,CAAC,IAAI,CAAC,CAAA,oBAAA,EAAuB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAAC;YAChE;AACA,YAAA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB;;AAEJ;AAEM,SAAU,kBAAkB,CAAC,MAAiB,EAAA;AAClD,IAAA,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;AACE,QAAA,WAAW,EACT,gIAAgI;AAClI,QAAA,WAAW,EAAE;AACX,YAAA,YAAY,EAAE,IAAI;AAClB,YAAA,eAAe,EAAE,KAAK;AACtB,YAAA,aAAa,EAAE,KAAK;AACrB,SAAA;KACF,EACD,YAAW;AACT,QAAA,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE;QAClC,OAAO;AACL,YAAA,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;SAChE;AACH,IAAA,CAAC,CACF;AACH;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kunobi/mcp",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "MCP server for Kunobi — platform management for AI assistants",
   "type": "module",
   "license": "Apache-2.0",