cssprobe-cli 0.2.26 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes are documented on the [GitHub Releases](https://github.com/mack-peng/cssprobe-cli/releases) page.
 
+## [0.3.0] - 2026-09-16
+
+### Added
+- MCP server (`cssprobe-cli mcp`, stdio): 10 tools — open / inspect / tree / layout / findings / eval / screenshot / inject_css / close / status
+- `mcp-install` / `mcp-uninstall`: auto-configure MCP clients (Claude Code, Cursor, Codex CLI, opencode, Gemini CLI, Hermes)
+- `mcpName` (`io.github.mack-peng/cssprobe-cli`) for the official MCP Registry
+- README MCP section; `llms.txt` MCP pointer
+
+### Changed
+- Session commands (open/close/status/inspect/…) now share one implementation between CLI and MCP (`src/cli/session-ops.ts`); behavior unchanged
+
 ## [0.2.26] - 2026-09-16
 
 ### Added

package/README.md

@@ -119,6 +119,30 @@ cssprobe-cli inspect body --json
 cssprobe-cli inspect body --json | jq '.findings[] | {id, confidence, message}'
 ```
 
+### 4. Use as an MCP Server (AI clients)
+
+cssprobe-cli ships an MCP server (stdio), so AI clients call it as a native tool — no shell needed:
+
+```bash
+cssprobe-cli mcp-install          # auto-detect and configure installed clients
+cssprobe-cli mcp-install --target=claude,cursor,codex
+cssprobe-cli mcp-install --local  # write project-scoped config
+```
+
+Manual configuration for any MCP client:
+
+```json
+{
+  "mcpServers": {
+    "cssprobe-cli": { "command": "cssprobe-cli", "args": ["mcp"] }
+  }
+}
+```
+
+Exposes 10 tools: `cssprobe_open`, `cssprobe_inspect`, `cssprobe_tree`, `cssprobe_layout`,
+`cssprobe_findings`, `cssprobe_eval`, `cssprobe_screenshot`, `cssprobe_inject_css`,
+`cssprobe_close`, `cssprobe_status`. Remove with `cssprobe-cli mcp-uninstall`.
+
 ---
 
 ## Commands

package/dist/cli/commands.js

@@ -247,6 +247,30 @@ const skillUninstall = (0, command_1.declareCommand)({
         path: z.string().optional().describe('custom base directory'),
     }),
 });
+// ── mcp ──
+const mcp = (0, command_1.declareCommand)({
+    name: 'mcp',
+    category: 'core',
+    description: 'Start MCP server (stdio transport) for AI clients',
+});
+const mcpInstall = (0, command_1.declareCommand)({
+    name: 'mcp-install',
+    category: 'core',
+    description: 'Install MCP server config into AI client configs',
+    options: z.object({
+        target: z.string().optional().describe('client target: auto, all, none, claude, cursor, codex, opencode, hermes, gemini (default: auto)'),
+        local: z.boolean().optional().describe('write project-local config instead of global'),
+    }),
+});
+const mcpUninstall = (0, command_1.declareCommand)({
+    name: 'mcp-uninstall',
+    category: 'core',
+    description: 'Remove MCP server config from AI client configs',
+    options: z.object({
+        target: z.string().optional().describe('client target: auto, all, none, claude, cursor, codex, opencode, hermes, gemini (default: auto)'),
+        local: z.boolean().optional().describe('remove project-local config instead of global'),
+    }),
+});
 // ── export ──
 const commandsArray = [
     // session management
@@ -261,6 +285,8 @@ const commandsArray = [
     configShow, configSet, configList, configUse, configNew, configPath,
     // skill
     skillInstall, skillUninstall,
+    // mcp
+    mcp, mcpInstall, mcpUninstall,
 ];
 exports.commands = Object.fromEntries(commandsArray.map(cmd => [cmd.name, cmd]));
 exports.inspectCommand = inspect;

package/dist/cli/program.js

@@ -13,6 +13,8 @@ const commands_1 = require("./commands");
 const output_1 = require("./output");
 const config_1 = require("../config/config");
 const session_1 = require("../daemon/session");
+const session_ops_1 = require("./session-ops");
+const mcp_1 = require("../mcp");
 const globalOptions = ['json', 'raw', 'help', 'h', 'version', 'v', 'p', 'profile'];
 const booleanGlobalOptions = ['help', 'json', 'raw', 'version', 'v', 'h'];
 async function program() {
@@ -37,8 +39,13 @@ async function program() {
         return;
     if (handleSkillCommands(commandName, command, rawArgs, output))
         return;
+    if (handleMcpInstallCommands(commandName, command, rawArgs, output))
+        return;
     // Session-based commands
     switch (commandName) {
+        case 'mcp':
+            await (0, mcp_1.runMcpServer)();
+            return;
         case 'open':
             await handleOpen(command, rawArgs, output);
             return;
@@ -111,12 +118,8 @@ async function handleOpen(command, args, output) {
     try {
         const cmdArgs = splitArgs(args);
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
-        const url = parsed.url || 'about:blank';
-        const browser = parsed.browser || 'chromium';
-        const headed = !!parsed.headed;
-        const viewportStr = parsed.viewport;
-        const state = parsed.state;
         // Parse viewport
+        const viewportStr = parsed.viewport;
         let viewport;
         if (viewportStr) {
             const parts = viewportStr.split('x');
@@ -132,90 +135,41 @@ async function handleOpen(command, args, output) {
             }
             viewport = { width, height };
         }
-        // Start daemon
-        const { pid } = await session_1.Session.startDaemon({
-            browser,
-            headed,
+        const result = await (0, session_ops_1.openSession)({
+            url: parsed.url,
+            browser: parsed.browser,
+            headed: !!parsed.headed,
             viewport,
-            state,
-            _: ['open', url],
-        }, 'open');
-        // Wait for the daemon to be ready (poll session file instead of fixed delay)
-        const session = await waitForSession(5000);
-        if (!session)
-            throw new Error('Daemon failed to become ready within 5s. Check the daemon log for errors.');
-        await session.run({ _: ['goto', url] });
-        const result = {
-            sessionId: 'default',
-            pid,
-            url,
-            viewport: viewport || { width: 1280, height: 720 },
-        };
+            state: parsed.state,
+        });
         if (output.json) {
             console.log(JSON.stringify(result, null, 2));
         }
         else {
-            console.log(`Browser opened at ${url}`);
-            console.log(`Session ID: default`);
-            console.log(`PID: ${pid}`);
-            console.log(`Viewport: ${viewport?.width || 1280}x${viewport?.height || 720}`);
+            console.log(`Browser opened at ${result.url}`);
+            console.log(`Session ID: ${result.sessionId}`);
+            console.log(`PID: ${result.pid}`);
+            console.log(`Viewport: ${result.viewport.width}x${result.viewport.height}`);
         }
     }
     catch (e) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
-async function waitForSession(timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        const session = await (0, session_1.loadSession)();
-        if (session && await session.canConnect())
-            return session;
-        await new Promise(resolve => setTimeout(resolve, 100));
-    }
-    return undefined;
-}
 async function handleClose(command, args, output) {
     try {
         const cmdArgs = splitArgs(args);
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
-        if (parsed.all) {
-            const sessions = await (0, session_1.listAllSessions)();
-            if (sessions.length === 0) {
-                output.error('No active sessions found.');
-                return;
-            }
-            const results = [];
-            for (const session of sessions) {
-                try {
-                    await session.stop();
-                    results.push({ sessionId: session.name, closed: true });
-                }
-                catch (e) {
-                    results.push({ sessionId: session.name, closed: false, error: e.message });
-                }
-            }
-            if (output.json) {
-                console.log(JSON.stringify({ closed: results }, null, 2));
-            }
-            else {
-                const closedCount = results.filter(r => r.closed).length;
-                console.log(`Closed ${closedCount} session(s).`);
-            }
+        const result = await (0, session_ops_1.closeSession)(!!parsed.all);
+        if (output.json) {
+            console.log(JSON.stringify(parsed.all ? { closed: result.sessions } : { closed: true, sessionId: 'default' }, null, 2));
+        }
+        else if (parsed.all) {
+            const closedCount = result.sessions.filter(r => r.closed).length;
+            console.log(`Closed ${closedCount} session(s).`);
         }
         else {
-            const session = await (0, session_1.loadSession)();
-            if (!session) {
-                output.error('No active session. Run: cssprobe-cli open <url>');
-                return;
-            }
-            await session.stop();
-            if (output.json) {
-                console.log(JSON.stringify({ closed: true, sessionId: 'default' }, null, 2));
-            }
-            else {
-                console.log('Browser closed.');
-            }
+            console.log('Browser closed.');
         }
     }
     catch (e) {
@@ -224,32 +178,19 @@ async function handleClose(command, args, output) {
 }
 async function handleStatus(output) {
     try {
-        const session = await (0, session_1.loadSession)();
-        if (!session) {
-            const result = { sessionId: 'default', alive: false };
-            if (output.json) {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                console.log('No active session.');
-            }
-            return;
-        }
-        const canConnect = await session.canConnect();
-        const result = {
-            sessionId: 'default',
-            alive: canConnect,
-            config: session.config,
-        };
+        const result = await (0, session_ops_1.getSessionStatus)();
         if (output.json) {
             console.log(JSON.stringify(result, null, 2));
+            return;
         }
-        else {
-            console.log(`Session: default`);
-            console.log(`Status: ${canConnect ? 'alive' : 'dead'}`);
-            if (canConnect) {
-                console.log(`Browser: ${session.config.browser.browserName}`);
-            }
+        if (!result.config) {
+            console.log('No active session.');
+            return;
+        }
+        console.log(`Session: default`);
+        console.log(`Status: ${result.alive ? 'alive' : 'dead'}`);
+        if (result.alive) {
+            console.log(`Browser: ${result.config.browser.browserName}`);
         }
     }
     catch (e) {
@@ -258,49 +199,12 @@ async function handleStatus(output) {
 }
 async function handleSessionCommand(commandName, command, args, output) {
     try {
-        const session = await (0, session_1.loadSession)();
-        if (!session) {
-            output.error('No active session. Run: cssprobe-cli open <url>');
-            return;
-        }
         const cmdArgs = splitArgs(args);
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
-        // Build command args for daemon
-        const daemonArgs = [commandName];
-        // Add positional args
-        if (command.args) {
-            const argsSchema = command.args;
-            const argNames = Object.keys(argsSchema.shape);
-            for (const name of argNames) {
-                if (parsed[name] !== undefined) {
-                    daemonArgs.push(String(parsed[name]));
-                }
-            }
-        }
-        // Add options
-        if (command.options) {
-            const optionsSchema = command.options;
-            const optionNames = Object.keys(optionsSchema.shape);
-            for (const name of optionNames) {
-                if (parsed[name] !== undefined) {
-                    if (typeof parsed[name] === 'boolean') {
-                        if (parsed[name])
-                            daemonArgs.push(`--${name}`);
-                    }
-                    else {
-                        daemonArgs.push(`--${name}=${parsed[name]}`);
-                    }
-                }
-            }
-        }
-        // Run command in session
-        const runArgs = { ...cmdArgs, _: daemonArgs };
-        if (args.json)
-            runArgs.json = true;
-        const result = await session.run(runArgs);
+        const result = await (0, session_ops_1.runSessionCommand)(commandName, command, parsed, !!args.json);
         // Screenshot: save the base64 data URL to a file and report the path
         if (commandName === 'screenshot' && typeof result.text === 'string' && result.text.startsWith('data:image/png;base64,')) {
-            const saved = saveScreenshotFile(result.text, parsed.out);
+            const saved = (0, session_ops_1.saveScreenshotFile)(result.text, parsed.out);
             if (output.json) {
                 console.log(JSON.stringify({ saved }, null, 2));
             }
@@ -315,24 +219,6 @@ async function handleSessionCommand(commandName, command, args, output) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
-function saveScreenshotFile(dataUrl, out) {
-    const base64 = dataUrl.replace(/^data:image\/png;base64,/, '');
-    const buffer = Buffer.from(base64, 'base64');
-    const resolvedOut = out
-        ? path_1.default.resolve(out)
-        : (() => {
-            const dir = path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'screenshots');
-            if (!fs_1.default.existsSync(dir))
-                fs_1.default.mkdirSync(dir, { recursive: true });
-            const ts = new Date().toISOString().replace(/[:.]/g, '-');
-            return path_1.default.join(dir, `screenshot-${ts}.png`);
-        })();
-    const dir = path_1.default.dirname(resolvedOut);
-    if (!fs_1.default.existsSync(dir))
-        fs_1.default.mkdirSync(dir, { recursive: true });
-    fs_1.default.writeFileSync(resolvedOut, buffer);
-    return resolvedOut;
-}
 // ── config commands ──
 function handleConfigCommands(commandName, command, args, output) {
     try {
@@ -426,6 +312,27 @@ function handleSkillCommands(commandName, command, args, output) {
     }
     return false;
 }
+// ── mcp-install commands ──
+function handleMcpInstallCommands(commandName, command, args, output) {
+    if (commandName !== 'mcp-install' && commandName !== 'mcp-uninstall')
+        return false;
+    const targetFlag = args.target || 'auto';
+    const loc = args.local ? 'local' : 'global';
+    try {
+        const result = commandName === 'mcp-install'
+            ? (0, installer_1.installMcpConfig)(loc, targetFlag)
+            : (0, installer_1.uninstallMcpConfig)(loc, targetFlag);
+        const summary = result.files.map(f => `${f.agent}: ${f.action} ${f.path}`);
+        for (const note of result.notes)
+            summary.push(`note: ${note}`);
+        console.log(output.format({ files: summary }));
+        return true;
+    }
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
+    }
+    return false;
+}
 function parseNetscapeCookies(content) {
     const cookies = [];
     const lines = content.split('\n');

package/dist/cli/session-ops.d.ts

@@ -0,0 +1,43 @@
+import { Session } from '../daemon/session';
+import type { SessionConfig } from '../daemon/session';
+import type { AnyCommandSchema } from './command';
+export interface OpenOptions {
+    url?: string;
+    browser?: string;
+    headed?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    state?: string;
+}
+export interface OpenResult {
+    sessionId: string;
+    pid?: number;
+    url: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+}
+export declare function openSession(opts: OpenOptions): Promise<OpenResult>;
+export declare function waitForSession(timeoutMs: number): Promise<Session | undefined>;
+export interface CloseResult {
+    sessions: Array<{
+        sessionId: string;
+        closed: boolean;
+        error?: string;
+    }>;
+}
+export declare function closeSession(all?: boolean): Promise<CloseResult>;
+export interface StatusResult {
+    sessionId: string;
+    alive: boolean;
+    config?: SessionConfig;
+}
+export declare function getSessionStatus(): Promise<StatusResult>;
+export declare function buildDaemonArgs(commandName: string, command: AnyCommandSchema, parsed: Record<string, unknown>): string[];
+export declare function runSessionCommand(commandName: string, command: AnyCommandSchema, parsed: Record<string, unknown>, json?: boolean): Promise<{
+    text: string;
+}>;
+export declare function saveScreenshotFile(dataUrl: string, out?: string): string;

package/dist/cli/session-ops.js

@@ -0,0 +1,163 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openSession = openSession;
+exports.waitForSession = waitForSession;
+exports.closeSession = closeSession;
+exports.getSessionStatus = getSessionStatus;
+exports.buildDaemonArgs = buildDaemonArgs;
+exports.runSessionCommand = runSessionCommand;
+exports.saveScreenshotFile = saveScreenshotFile;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const session_1 = require("../daemon/session");
+async function openSession(opts) {
+    const url = opts.url || 'about:blank';
+    const browser = opts.browser || 'chromium';
+    const { pid } = await session_1.Session.startDaemon({
+        browser,
+        headed: !!opts.headed,
+        viewport: opts.viewport,
+        state: opts.state,
+        _: ['open', url],
+    }, 'open');
+    const session = await waitForSession(5000);
+    if (!session)
+        throw new Error('Daemon failed to become ready within 5s. Check the daemon log for errors.');
+    await session.run({ _: ['goto', url] });
+    return {
+        sessionId: 'default',
+        pid,
+        url,
+        viewport: opts.viewport || { width: 1280, height: 720 },
+    };
+}
+async function waitForSession(timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const session = await (0, session_1.loadSession)();
+        if (session && await session.canConnect())
+            return session;
+        await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    return undefined;
+}
+async function closeSession(all = false) {
+    if (all) {
+        const sessions = await (0, session_1.listAllSessions)();
+        if (sessions.length === 0)
+            throw new Error('No active sessions found.');
+        const results = [];
+        for (const session of sessions) {
+            try {
+                await session.stop();
+                results.push({ sessionId: session.name, closed: true });
+            }
+            catch (e) {
+                results.push({ sessionId: session.name, closed: false, error: e.message });
+            }
+        }
+        return { sessions: results };
+    }
+    const session = await (0, session_1.loadSession)();
+    if (!session)
+        throw new Error('No active session. Run: cssprobe-cli open <url>');
+    await session.stop();
+    return { sessions: [{ sessionId: 'default', closed: true }] };
+}
+async function getSessionStatus() {
+    const session = await (0, session_1.loadSession)();
+    if (!session)
+        return { sessionId: 'default', alive: false };
+    const canConnect = await session.canConnect();
+    return {
+        sessionId: 'default',
+        alive: canConnect,
+        config: session.config,
+    };
+}
+function buildDaemonArgs(commandName, command, parsed) {
+    const daemonArgs = [commandName];
+    if (command.args) {
+        for (const name of Object.keys(command.args.shape)) {
+            if (parsed[name] !== undefined)
+                daemonArgs.push(String(parsed[name]));
+        }
+    }
+    if (command.options) {
+        for (const name of Object.keys(command.options.shape)) {
+            if (parsed[name] === undefined)
+                continue;
+            if (typeof parsed[name] === 'boolean') {
+                if (parsed[name])
+                    daemonArgs.push(`--${name}`);
+            }
+            else {
+                daemonArgs.push(`--${name}=${parsed[name]}`);
+            }
+        }
+    }
+    return daemonArgs;
+}
+async function runSessionCommand(commandName, command, parsed, json = false) {
+    const session = await (0, session_1.loadSession)();
+    if (!session)
+        throw new Error('No active session. Run: cssprobe-cli open <url>');
+    const daemonArgs = buildDaemonArgs(commandName, command, parsed);
+    const runArgs = { ...parsed, _: daemonArgs };
+    if (json)
+        runArgs.json = true;
+    return await session.run(runArgs);
+}
+function saveScreenshotFile(dataUrl, out) {
+    const base64 = dataUrl.replace(/^data:image\/png;base64,/, '');
+    const buffer = Buffer.from(base64, 'base64');
+    const resolvedOut = out
+        ? path.resolve(out)
+        : (() => {
+            const dir = path.join(os.homedir(), '.cssprobe-cli', 'screenshots');
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            const ts = new Date().toISOString().replace(/[:.]/g, '-');
+            return path.join(dir, `screenshot-${ts}.png`);
+        })();
+    const dir = path.dirname(resolvedOut);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(resolvedOut, buffer);
+    return resolvedOut;
+}
+//# sourceMappingURL=session-ops.js.map

package/dist/help.json

@@ -1,5 +1,5 @@
 {
-  "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  state-import [file]         import cookies from netscape format file\n  state-save                  save current browser session state (cookies + localstorage)\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
+  "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  state-import [file]         import cookies from netscape format file\n  state-save                  save current browser session state (cookies + localstorage)\n  mcp                         start mcp server (stdio transport) for ai clients\n  mcp-install                 install mcp server config into ai client configs\n  mcp-uninstall               remove mcp server config from ai client configs\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
   "commands": {
     "open": {
       "help": "cssprobe-cli open [url]\n\nOpen browser in session mode (non-blocking)\n\nArguments:\n  [url]                       url, file:// path, or local html file path\nOptions:\n  --browser                   browser engine (default chromium)\n  --headed                    show the browser window\n  --viewport                  viewport size as wxh (e.g. 1280x720)\n  --state                     path to saved state file (cookies + localstorage)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
@@ -173,6 +173,27 @@
         "path": "string"
       },
       "args": []
+    },
+    "mcp": {
+      "help": "cssprobe-cli mcp \n\nStart MCP server (stdio transport) for AI clients\n\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {},
+      "args": []
+    },
+    "mcp-install": {
+      "help": "cssprobe-cli mcp-install \n\nInstall MCP server config into AI client configs\n\nOptions:\n  --target                    client target: auto, all, none, claude, cursor, codex, opencode, hermes, gemini (default: auto)\n  --local                     write project-local config instead of global\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "target": "string",
+        "local": "boolean"
+      },
+      "args": []
+    },
+    "mcp-uninstall": {
+      "help": "cssprobe-cli mcp-uninstall \n\nRemove MCP server config from AI client configs\n\nOptions:\n  --target                    client target: auto, all, none, claude, cursor, codex, opencode, hermes, gemini (default: auto)\n  --local                     remove project-local config instead of global\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "target": "string",
+        "local": "boolean"
+      },
+      "args": []
     }
   },
   "booleanOptions": [

package/dist/installer/index.d.ts

@@ -1,3 +1,5 @@
 export { buildSkillMd, buildPitfallsMd } from './skill-template';
 export { ALL_TARGETS, getTarget, listTargetIds, resolveTargetFlag } from './targets/registry';
 export type { AgentTarget, Location, TargetId, WriteResult } from './targets/types';
+export { installMcpConfig, uninstallMcpConfig, listMcpClientIds, MCP_SERVER_NAME } from './mcp';
+export type { McpCommandResult, McpFileResult } from './mcp';

package/dist/installer/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveTargetFlag = exports.listTargetIds = exports.getTarget = exports.ALL_TARGETS = exports.buildPitfallsMd = exports.buildSkillMd = void 0;
+exports.MCP_SERVER_NAME = exports.listMcpClientIds = exports.uninstallMcpConfig = exports.installMcpConfig = exports.resolveTargetFlag = exports.listTargetIds = exports.getTarget = exports.ALL_TARGETS = exports.buildPitfallsMd = exports.buildSkillMd = void 0;
 var skill_template_1 = require("./skill-template");
 Object.defineProperty(exports, "buildSkillMd", { enumerable: true, get: function () { return skill_template_1.buildSkillMd; } });
 Object.defineProperty(exports, "buildPitfallsMd", { enumerable: true, get: function () { return skill_template_1.buildPitfallsMd; } });
@@ -9,4 +9,9 @@ Object.defineProperty(exports, "ALL_TARGETS", { enumerable: true, get: function
 Object.defineProperty(exports, "getTarget", { enumerable: true, get: function () { return registry_1.getTarget; } });
 Object.defineProperty(exports, "listTargetIds", { enumerable: true, get: function () { return registry_1.listTargetIds; } });
 Object.defineProperty(exports, "resolveTargetFlag", { enumerable: true, get: function () { return registry_1.resolveTargetFlag; } });
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "installMcpConfig", { enumerable: true, get: function () { return mcp_1.installMcpConfig; } });
+Object.defineProperty(exports, "uninstallMcpConfig", { enumerable: true, get: function () { return mcp_1.uninstallMcpConfig; } });
+Object.defineProperty(exports, "listMcpClientIds", { enumerable: true, get: function () { return mcp_1.listMcpClientIds; } });
+Object.defineProperty(exports, "MCP_SERVER_NAME", { enumerable: true, get: function () { return mcp_1.MCP_SERVER_NAME; } });
 //# sourceMappingURL=index.js.map

package/dist/installer/mcp.d.ts

@@ -0,0 +1,14 @@
+import type { Location, TargetId } from './targets/types';
+export declare const MCP_SERVER_NAME = "cssprobe-cli";
+export interface McpFileResult {
+    path: string;
+    action: 'created' | 'updated' | 'unchanged' | 'removed' | 'not-found' | 'kept';
+    agent: string;
+}
+export interface McpCommandResult {
+    files: McpFileResult[];
+    notes: string[];
+}
+export declare function installMcpConfig(loc: Location, targetFlag?: string): McpCommandResult;
+export declare function uninstallMcpConfig(loc: Location, targetFlag?: string): McpCommandResult;
+export declare function listMcpClientIds(): TargetId[];