@sudu-cli/fronted-preview-mcp 1.0.0-beta.0

package/README.md

@@ -0,0 +1,67 @@
+# @sudu-cli/fronted-preview-mcp
+
+MCP server 用于前端项目框架检测和 dev server 管理。与 `chrome-devtools-mcp` 配合使用，实现自动化前端预览和错误检查工作流。
+
+## 安装
+
+```bash
+# 在项目中初始化配置
+npx @sudu-cli/fronted-preview-mcp init
+```
+
+## 使用方法
+
+```bash
+# 启动 MCP server（opencode 自动调用）
+npx @sudu-cli/fronted-preview-mcp
+
+# 在项目中初始化 opencode 配置
+npx @sudu-cli/fronted-preview-mcp init
+
+# 查看帮助
+npx @sudu-cli/fronted-preview-mcp --help
+```
+
+## 工具
+
+| 工具 | 说明 |
+|------|------|
+| `quick_preview` | **推荐**。检测框架 + 启动 dev server，一步完成 |
+| `get_project_info` | 仅检测项目框架信息 |
+| `start_dev_server` | 仅启动 dev server |
+| `stop_dev_server` | 停止 dev server |
+
+### 推荐工作流
+
+调用 `quick_preview` 后，按顺序执行：
+
+1. **chrome-devtools** `navigate_page(url)` — 打开页面
+2. **chrome-devtools** `list_console_messages()` — 检查 console 错误
+3. **chrome-devtools** `take_snapshot()` — 分析页面结构
+
+## 配置
+
+`npx @sudu-cli/fronted-preview-mcp init` 会生成：
+
+```
+项目目录/
+├── opencode.json                           # MCP 服务器配置
+└── .opencode/
+    ├── agents/preview-checker.md           # 可选：子智能体
+    └── frontend-preview/instructions.md    # 工作流说明
+```
+
+## 要求
+
+- Node.js >= 18
+- opencode 或其他 MCP 客户端
+- chrome-devtools-mcp（自动配置）
+
+## 开发
+
+```bash
+npm install
+npm run build    # 编译 TypeScript
+npm run dev      # 监听模式
+node dist/cli.js --help
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { main as runMcpServer } from './index.js';
+async function showHelp() {
+    console.log(`
+@sudu-cli/fronted-preview-mcp v1.0.0 — Frontend preview MCP server
+
+USAGE:
+  fronted-preview-mcp               Start MCP server (stdio — used by opencode)
+  fronted-preview-mcp init          Initialize project configuration for team use
+  fronted-preview-mcp --help        Show this help
+
+DESCRIPTION:
+  An MCP server that detects frontend framework and manages dev server lifecycle.
+  Designed to work alongside chrome-devtools-mcp for automated frontend preview
+  and error checking workflows.
+
+COMMANDS:
+  init    Generate .opencode/agents/, .opencode/skills/, and opencode.json
+          for the current project. Run this once per project.
+
+  (no arguments)   Default mode. Starts the MCP server with stdio transport,
+                   used by opencode as a local MCP server.
+
+EXAMPLES:
+  npx @sudu-cli/fronted-preview-mcp           Start MCP server
+  npx @sudu-cli/fronted-preview-mcp init      Set up project configuration
+  npx @sudu-cli/fronted-preview-mcp --help    Show this help
+`);
+}
+async function cli() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (command === 'init') {
+        const { init } = await import('./commands/init.js');
+        await init(args.slice(1));
+    }
+    else if (command === '--help' || command === '-h') {
+        await showHelp();
+    }
+    else {
+        // Default: MCP server mode
+        await runMcpServer();
+    }
+}
+cli().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAElD,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,2BAA2B;QAC3B,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function init(args: string[]): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,153 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+// Get the package root directory (2 levels up from __dirname in src/commands/)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PKG_ROOT = path.resolve(__dirname, '..', '..');
+const TEMPLATES_DIR = path.join(PKG_ROOT, 'templates', 'init');
+export async function init(args) {
+    const options = parseArgs(args);
+    const targetDir = path.resolve(process.cwd(), options.targetDir);
+    console.log('');
+    console.log('  ⚡ frontend-preview init');
+    console.log(`  Target: ${targetDir}`);
+    console.log('');
+    // Check if target directory exists
+    if (!fs.existsSync(targetDir)) {
+        console.error(`  ✖ Directory not found: ${targetDir}`);
+        process.exit(1);
+    }
+    // Check if it looks like a frontend project
+    const hasPackageJson = fs.existsSync(path.join(targetDir, 'package.json'));
+    if (!hasPackageJson) {
+        console.warn('  ⚠ No package.json found — this may not be a frontend project.');
+        console.warn('    Proceeding anyway...');
+        console.warn('');
+    }
+    // 1. Create .opencode directory structure
+    const opencodeDir = path.join(targetDir, '.opencode');
+    const instructionsDir = path.join(opencodeDir, 'frontend-preview');
+    fs.mkdirSync(instructionsDir, { recursive: true });
+    console.log(`  ✓ Created .opencode/frontend-preview/`);
+    // 2. Write instructions.md from template
+    const instructionsSrc = path.join(TEMPLATES_DIR, 'instructions.md');
+    const instructionsDest = path.join(instructionsDir, 'instructions.md');
+    if (fs.existsSync(instructionsDest) && !options.force) {
+        console.log(`  - Skipped instructions.md (already exists, use --force to overwrite)`);
+    }
+    else {
+        if (fs.existsSync(instructionsSrc)) {
+            const content = fs.readFileSync(instructionsSrc, 'utf-8');
+            fs.writeFileSync(instructionsDest, content, 'utf-8');
+            console.log(`  ✓ Created .opencode/frontend-preview/instructions.md`);
+        }
+        else {
+            console.warn(`  ⚠ Template not found: ${instructionsSrc}`);
+        }
+    }
+    // 3. Write agent.md from template (optional — for subagent workflow)
+    const agentDir = path.join(opencodeDir, 'agents');
+    const agentSrc = path.join(TEMPLATES_DIR, 'agent.md');
+    const agentDest = path.join(agentDir, 'preview-checker.md');
+    if (fs.existsSync(agentDest) && !options.force) {
+        console.log(`  - Skipped agents/preview-checker.md (already exists, use --force to overwrite)`);
+    }
+    else {
+        if (fs.existsSync(agentSrc)) {
+            fs.mkdirSync(agentDir, { recursive: true });
+            const content = fs.readFileSync(agentSrc, 'utf-8');
+            fs.writeFileSync(agentDest, content, 'utf-8');
+            console.log(`  ✓ Created .opencode/agents/preview-checker.md`);
+        }
+        else {
+            console.warn(`  ⚠ Template not found: ${agentSrc}`);
+        }
+    }
+    // 4. Update or create opencode.json
+    const configPath = path.join(targetDir, 'opencode.json');
+    let existingConfig = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            const raw = fs.readFileSync(configPath, 'utf-8');
+            existingConfig = JSON.parse(raw);
+            console.log(`  ✓ Found existing opencode.json — merging config`);
+        }
+        catch {
+            console.warn(`  ⚠ Could not parse existing opencode.json, will create new one`);
+            existingConfig = {};
+        }
+    }
+    // Merge MCP servers config
+    if (!existingConfig['mcp']) {
+        existingConfig['mcp'] = {};
+    }
+    const mcp = existingConfig['mcp'];
+    if (!mcp['frontend-preview']) {
+        mcp['frontend-preview'] = {
+            type: 'local',
+            command: ['npx', '-y', 'frontend-preview'],
+        };
+        console.log(`  ✓ Added frontend-preview MCP server`);
+    }
+    else {
+        console.log(`  - frontend-preview MCP already configured`);
+    }
+    if (!mcp['chrome-devtools']) {
+        mcp['chrome-devtools'] = {
+            type: 'local',
+            command: ['npx', '-y', 'chrome-devtools-mcp@latest'],
+        };
+        console.log(`  ✓ Added chrome-devtools MCP server`);
+    }
+    else {
+        console.log(`  - chrome-devtools MCP already configured`);
+    }
+    // Merge instructions
+    const instructionsPath = '.opencode/frontend-preview/instructions.md';
+    if (!existingConfig['instructions']) {
+        existingConfig['instructions'] = [instructionsPath];
+        console.log(`  ✓ Added instructions reference`);
+    }
+    else {
+        const instructions = existingConfig['instructions'];
+        if (!instructions.includes(instructionsPath)) {
+            instructions.push(instructionsPath);
+            console.log(`  ✓ Added instructions.md to instructions list`);
+        }
+        else {
+            console.log(`  - instructions.md already referenced`);
+        }
+    }
+    // Ensure $schema
+    if (!existingConfig['$schema']) {
+        existingConfig['$schema'] = 'https://opencode.ai/config.json';
+    }
+    // Write updated config
+    fs.writeFileSync(configPath, JSON.stringify(existingConfig, null, 2) + '\n', 'utf-8');
+    console.log(`  ✓ Updated opencode.json`);
+    // Summary
+    console.log('');
+    console.log('  ─────────────────────────────────────────────');
+    console.log('  ✅ Setup complete!');
+    console.log('');
+    console.log('  Next steps:');
+    console.log(`    1. cd ${path.relative(process.cwd(), targetDir) || '.'}`);
+    console.log('    2. opencode');
+    console.log('    3. Say: "检查一下页面效果"');
+    console.log('');
+}
+function parseArgs(args) {
+    let targetDir = '.';
+    let force = false;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--force' || args[i] === '-f') {
+            force = true;
+        }
+        else if (!args[i].startsWith('-')) {
+            targetDir = args[i];
+        }
+    }
+    return { targetDir, force };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/detectors/frameworkDetector.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectInfo } from '../types.js';
+declare function detectFramework(projectDir: string): Promise<ProjectInfo>;
+export { detectFramework };

package/dist/detectors/frameworkDetector.js

@@ -0,0 +1,160 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const FRAMEWORK_CONFIGS = [
+    {
+        framework: 'vite',
+        port: 5173,
+        configFiles: ['vite.config.ts', 'vite.config.js', 'vite.config.mjs'],
+        depKeys: ['vite'],
+    },
+    {
+        framework: 'nextjs',
+        port: 3000,
+        configFiles: ['next.config.js', 'next.config.mjs', 'next.config.ts'],
+        depKeys: ['next'],
+    },
+    {
+        framework: 'vue-cli',
+        port: 8080,
+        configFiles: ['vue.config.js'],
+        depKeys: ['@vue/cli-service'],
+    },
+    {
+        framework: 'cra',
+        port: 3000,
+        configFiles: [],
+        depKeys: ['react-scripts'],
+    },
+    {
+        framework: 'webpack',
+        port: 8080,
+        configFiles: ['webpack.config.js', 'webpack.config.ts'],
+        depKeys: ['webpack-dev-server', 'webpack'],
+    },
+];
+const DEV_SCRIPT_NAMES = ['dev', 'serve', 'start'];
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function extractPortFromConfig(configContent) {
+    const portMatch = configContent.match(/port\s*[=:]\s*(\d{4,5})/);
+    if (portMatch) {
+        return parseInt(portMatch[1], 10);
+    }
+    return null;
+}
+async function detectFramework(projectDir) {
+    const pkgPath = path.join(projectDir, 'package.json');
+    let pkg = { scripts: {}, dependencies: {}, devDependencies: {} };
+    try {
+        const pkgContent = await fs.readFile(pkgPath, 'utf-8');
+        pkg = JSON.parse(pkgContent);
+    }
+    catch {
+        return {
+            framework: 'unknown',
+            port: 0,
+            devCommand: '',
+            devScript: '',
+            projectName: path.basename(projectDir),
+            hasNodeModules: await fileExists(path.join(projectDir, 'node_modules')),
+            npmScripts: {},
+        };
+    }
+    const allDeps = {
+        ...pkg.dependencies,
+        ...(pkg.devDependencies || {}),
+    };
+    const scripts = pkg.scripts || {};
+    const projectName = pkg.name || path.basename(projectDir);
+    const hasNodeModules = await fileExists(path.join(projectDir, 'node_modules'));
+    // Check each framework in priority order
+    for (const cfg of FRAMEWORK_CONFIGS) {
+        // Check config files
+        for (const configFile of cfg.configFiles) {
+            const configPath = path.join(projectDir, configFile);
+            if (await fileExists(configPath)) {
+                // Read config to extract custom port
+                const content = await fs.readFile(configPath, 'utf-8');
+                const customPort = extractPortFromConfig(content);
+                return {
+                    framework: cfg.framework,
+                    port: customPort ?? cfg.port,
+                    devCommand: findDevCommand(scripts, cfg.framework),
+                    devScript: findDevScriptName(scripts),
+                    projectName,
+                    hasNodeModules,
+                    npmScripts: scripts,
+                };
+            }
+        }
+        // Check dependencies
+        for (const key of cfg.depKeys) {
+            if (allDeps[key]) {
+                return {
+                    framework: cfg.framework,
+                    port: cfg.port,
+                    devCommand: findDevCommand(scripts, cfg.framework),
+                    devScript: findDevScriptName(scripts),
+                    projectName,
+                    hasNodeModules,
+                    npmScripts: scripts,
+                };
+            }
+        }
+    }
+    // Fallback: try to find any dev script
+    const devScript = findDevScriptName(scripts);
+    if (devScript) {
+        return {
+            framework: 'unknown',
+            port: 5173, // best guess
+            devCommand: scripts[devScript],
+            devScript,
+            projectName,
+            hasNodeModules,
+            npmScripts: scripts,
+        };
+    }
+    return {
+        framework: 'unknown',
+        port: 0,
+        devCommand: '',
+        devScript: '',
+        projectName,
+        hasNodeModules,
+        npmScripts: scripts,
+    };
+}
+function findDevScriptName(scripts) {
+    for (const name of DEV_SCRIPT_NAMES) {
+        if (scripts[name])
+            return name;
+    }
+    return '';
+}
+function findDevCommand(scripts, framework) {
+    if (scripts.dev)
+        return scripts.dev;
+    if (scripts.serve)
+        return scripts.serve;
+    if (scripts.start)
+        return scripts.start;
+    // Framework-specific defaults
+    const defaults = {
+        vite: 'vite',
+        nextjs: 'next dev',
+        'vue-cli': 'vue-cli-service serve',
+        cra: 'react-scripts start',
+        webpack: 'webpack serve --mode development',
+    };
+    return defaults[framework] || 'npm run dev';
+}
+export { detectFramework };
+//# sourceMappingURL=frameworkDetector.js.map

package/dist/detectors/frameworkDetector.js.map

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

package/dist/handlers/getProjectInfo.d.ts

@@ -0,0 +1,6 @@
+import type { MCPToolResponse } from '../types.js';
+interface GetProjectInfoArgs {
+    projectDir?: string;
+}
+declare function handleGetProjectInfo(args: GetProjectInfoArgs): Promise<MCPToolResponse>;
+export { handleGetProjectInfo };

package/dist/handlers/getProjectInfo.js

@@ -0,0 +1,30 @@
+import { detectFramework } from '../detectors/frameworkDetector.js';
+async function handleGetProjectInfo(args) {
+    try {
+        const projectDir = args.projectDir || process.cwd();
+        const info = await detectFramework(projectDir);
+        const result = {
+            projectName: info.projectName,
+            framework: info.framework,
+            port: info.port,
+            devScript: info.devScript,
+            devCommand: info.devCommand,
+            hasNodeModules: info.hasNodeModules,
+            hasDevScript: !!info.devScript,
+            npmScripts: info.npmScripts,
+            projectDir,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
+            isError: true,
+        };
+    }
+}
+export { handleGetProjectInfo };
+//# sourceMappingURL=getProjectInfo.js.map

package/dist/handlers/getProjectInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProjectInfo.js","sourceRoot":"","sources":["../../src/handlers/getProjectInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAOpE,KAAK,UAAU,oBAAoB,CAAC,IAAwB;IAC1D,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS;YAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU;SACX,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/handlers/quickPreview.d.ts

@@ -0,0 +1,7 @@
+import type { MCPToolResponse } from '../types.js';
+interface QuickPreviewArgs {
+    projectDir?: string;
+    customPort?: number;
+}
+declare function handleQuickPreview(args: QuickPreviewArgs): Promise<MCPToolResponse>;
+export { handleQuickPreview };

package/dist/handlers/quickPreview.js

@@ -0,0 +1,57 @@
+import { detectFramework } from '../detectors/frameworkDetector.js';
+import { startServer } from '../serverManager.js';
+async function handleQuickPreview(args) {
+    try {
+        const projectDir = args.projectDir || process.cwd();
+        // Step 1: Detect framework
+        const info = await detectFramework(projectDir);
+        if (!info.devScript) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No dev script found',
+                            availableScripts: Object.keys(info.npmScripts),
+                            projectDir,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Step 2: Start dev server (if not already running)
+        const port = args.customPort || info.port;
+        const command = `npm run ${info.devScript}`;
+        const status = await startServer(projectDir, command, port);
+        // Return combined result
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        url: status.url,
+                        port: status.port,
+                        ready: status.ready,
+                        framework: info.framework,
+                        projectName: info.projectName,
+                        devScript: info.devScript,
+                        devCommand: info.devCommand,
+                        pid: status.pid,
+                        startedAt: status.startedAt,
+                        projectDir,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
+            isError: true,
+        };
+    }
+}
+export { handleQuickPreview };
+//# sourceMappingURL=quickPreview.js.map

package/dist/handlers/quickPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickPreview.js","sourceRoot":"","sources":["../../src/handlers/quickPreview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAmB,MAAM,qBAAqB,CAAC;AAQnE,KAAK,UAAU,kBAAkB,CAAC,IAAsB;IACtD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAEpD,2BAA2B;QAC3B,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,qBAAqB;4BAC5B,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;4BAC9C,UAAU;yBACX,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC;QAC1C,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAE5D,yBAAyB;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,UAAU;qBACX,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/handlers/startDevServer.d.ts

@@ -0,0 +1,8 @@
+import type { MCPToolResponse } from '../types.js';
+interface StartDevServerArgs {
+    projectDir?: string;
+    customPort?: number;
+    customCommand?: string;
+}
+declare function handleStartDevServer(args: StartDevServerArgs): Promise<MCPToolResponse>;
+export { handleStartDevServer };

package/dist/handlers/startDevServer.js

@@ -0,0 +1,57 @@
+import { detectFramework } from '../detectors/frameworkDetector.js';
+import { startServer } from '../serverManager.js';
+async function handleStartDevServer(args) {
+    try {
+        const projectDir = args.projectDir || process.cwd();
+        // Detect framework to get port and command
+        const info = await detectFramework(projectDir);
+        if (!info.devScript && !args.customCommand) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No dev script found. Available scripts: ' + JSON.stringify(info.npmScripts),
+                            projectDir,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const port = args.customPort || info.port;
+        const command = args.customCommand || `${info.devScript}`;
+        const npmCommand = `npm run ${command}`;
+        // If it's a script name, resolve to npm run <script>
+        const resolvedCommand = info.npmScripts[command]
+            ? `npm run ${command}`
+            : command;
+        const status = await startServer(projectDir, resolvedCommand, port);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        url: status.url,
+                        port: status.port,
+                        pid: status.pid,
+                        ready: status.ready,
+                        startedAt: status.startedAt,
+                        framework: info.framework,
+                        projectName: info.projectName,
+                        command: resolvedCommand,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
+            isError: true,
+        };
+    }
+}
+export { handleStartDevServer };
+//# sourceMappingURL=startDevServer.js.map

package/dist/handlers/startDevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startDevServer.js","sourceRoot":"","sources":["../../src/handlers/startDevServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASlD,KAAK,UAAU,oBAAoB,CAAC,IAAwB;IAC1D,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAEpD,2CAA2C;QAC3C,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,0CAA0C,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;4BACnF,UAAU;yBACX,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,WAAW,OAAO,EAAE,CAAC;QAExC,qDAAqD;QACrD,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAC9C,CAAC,CAAC,WAAW,OAAO,EAAE;YACtB,CAAC,CAAC,OAAO,CAAC;QAEZ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;QAEpE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,OAAO,EAAE,eAAe;qBACzB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/handlers/stopDevServer.d.ts

@@ -0,0 +1,3 @@
+import type { MCPToolResponse } from '../types.js';
+declare function handleStopDevServer(): Promise<MCPToolResponse>;
+export { handleStopDevServer };

package/dist/handlers/stopDevServer.js

@@ -0,0 +1,29 @@
+import { stopServer, getServerStatus } from '../serverManager.js';
+async function handleStopDevServer() {
+    try {
+        const wasRunning = getServerStatus();
+        const result = await stopServer();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: result.success,
+                        message: result.message,
+                        wasRunning: !!wasRunning,
+                        previousUrl: wasRunning?.url || null,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
+            isError: true,
+        };
+    }
+}
+export { handleStopDevServer };
+//# sourceMappingURL=stopDevServer.js.map

package/dist/handlers/stopDevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopDevServer.js","sourceRoot":"","sources":["../../src/handlers/stopDevServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGlE,KAAK,UAAU,mBAAmB;IAChC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAElC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,IAAI;qBACrC,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function main(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,135 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import { z } from 'zod';
+import { handleGetProjectInfo } from './handlers/getProjectInfo.js';
+import { handleStartDevServer } from './handlers/startDevServer.js';
+import { handleStopDevServer } from './handlers/stopDevServer.js';
+import { handleQuickPreview } from './handlers/quickPreview.js';
+const server = new McpServer({
+    name: 'frontend-preview',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ============================================================
+// Tool: get_project_info
+// ============================================================
+server.tool('get_project_info', 'Detect frontend project framework and dev server settings. ' +
+    'Scans for vite.config.*, next.config.*, webpack.config.*, or reads package.json ' +
+    'dependencies to identify framework (Vite, Next.js, Vue CLI, CRA, Webpack). ' +
+    'Returns { framework, port, script, scripts, projectDir }.\n\n' +
+    'WHEN TO USE:\n' +
+    '- User asks "what framework is this?" or "what project is this?"\n' +
+    '- You need framework info before deciding how to start the server\n\n' +
+    'WHEN NOT TO USE:\n' +
+    '- User wants to preview or check the page — use quick_preview instead\n' +
+    '- User explicitly asks to start the dev server — use quick_preview\n\n' +
+    'AFTER THIS TOOL:\n' +
+    '- If you need to start the server, call start_dev_server (or quick_preview)\n' +
+    '- The returned "script" field tells you which npm script to run', {
+    projectDir: z
+        .string()
+        .optional()
+        .describe('Absolute path to the frontend project directory. Defaults to current working directory.'),
+}, async (args) => {
+    return await handleGetProjectInfo(args);
+});
+// ============================================================
+// Tool: start_dev_server
+// ============================================================
+server.tool('start_dev_server', 'Start the frontend dev server. Detects framework automatically, ' +
+    'resolves the dev script (npm run dev/serve/start), launches it as a ' +
+    'child process, and waits for the port to be ready.\n\n' +
+    'Returns { url, framework, port, script, ready }.\n\n' +
+    'WHEN TO USE:\n' +
+    '- Only when you ALREADY know the framework from get_project_info\n' +
+    '- Or when you need to customize port/command\n\n' +
+    'WHEN NOT TO USE:\n' +
+    '- If you haven\'t called get_project_info yet — use quick_preview instead\n' +
+    '- For most preview scenarios, quick_preview is simpler\n\n' +
+    'AFTER THIS TOOL:\n' +
+    '- Call chrome-devtools navigate_page with the returned URL\n' +
+    '- Then call list_console_messages to check for errors\n' +
+    '- Then call take_snapshot to inspect page structure', {
+    projectDir: z
+        .string()
+        .optional()
+        .describe('Absolute path to the frontend project directory.'),
+    customPort: z
+        .number()
+        .optional()
+        .describe('Override the auto-detected port number.'),
+    customCommand: z
+        .string()
+        .optional()
+        .describe('Override the dev command (e.g. "start" or "vite --port 3000").'),
+}, async (args) => {
+    return await handleStartDevServer(args);
+});
+// ============================================================
+// Tool: stop_dev_server
+// ============================================================
+server.tool('stop_dev_server', 'Stop the dev server started by start_dev_server or quick_preview. ' +
+    'Kills the child process and cleans up resources. ' +
+    'Safe to call even if no server is running.\n\n' +
+    'WHEN TO USE:\n' +
+    '- User explicitly says "stop the server" or "shut it down"\n\n' +
+    'WHEN NOT TO USE:\n' +
+    '- Do NOT call this automatically after preview — the server can stay running\n' +
+    '- Let the user explicitly ask to stop it', {}, async () => {
+    return await handleStopDevServer();
+});
+// ============================================================
+// Tool: quick_preview
+// ============================================================
+server.tool('quick_preview', 'ONE-STEP: detect frontend framework + start dev server. ' +
+    'Combines get_project_info and start_dev_server into a single call. ' +
+    'This is the PREFERRED tool for most scenarios.\n\n' +
+    'Returns { url, framework, port, script, ready, projectDir }.\n\n' +
+    'WHEN TO USE (PREFERRED):\n' +
+    '- User says "check the page", "preview", "see how it looks"\n' +
+    '- User says "start the dev server" or "run the project"\n' +
+    '- User reports something looks wrong on the page\n' +
+    '- ANY scenario where you need the page running\n\n' +
+    'WHEN NOT TO USE:\n' +
+    '- User only asks about project info — use get_project_info\n' +
+    '- User explicitly asks to stop — use stop_dev_server\n\n' +
+    'CRITICAL — AFTER THIS TOOL, USE THIS SEQUENCE:\n' +
+    '1. chrome-devtools navigate_page(url)       ← Open page in browser\n' +
+    '2. chrome-devtools list_console_messages()  ← Check for JS errors\n' +
+    '3. chrome-devtools take_snapshot()          ← Inspect page structure\n' +
+    '4. Report findings to the user\n\n' +
+    'Do NOT call get_project_info or start_dev_server separately when using this.\n' +
+    'The dev server stays running — no need to call stop_dev_server after preview.', {
+    projectDir: z
+        .string()
+        .optional()
+        .describe('Absolute path to the frontend project directory. Defaults to current working directory.'),
+    customPort: z
+        .number()
+        .optional()
+        .describe('Override the auto-detected port number. Only use if the user specifies a different port.'),
+}, async (args) => {
+    return await handleQuickPreview(args);
+});
+// ============================================================
+// Server startup
+// ============================================================
+export async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// When executed directly: `node dist/index.js` or `npx frontend-preview`
+const isMainModule = process.argv[1] &&
+    path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
+if (isMainModule) {
+    main().catch((err) => {
+        console.error('Fatal error:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/serverManager.d.ts

@@ -0,0 +1,8 @@
+import type { ServerStatus } from './types.js';
+declare function startServer(projectDir: string, devCommand: string, port: number): Promise<ServerStatus>;
+declare function stopServer(): Promise<{
+    success: boolean;
+    message: string;
+}>;
+declare function getServerStatus(): ServerStatus | null;
+export { startServer, stopServer, getServerStatus };

package/dist/serverManager.js

@@ -0,0 +1,166 @@
+import { spawn } from 'node:child_process';
+import * as net from 'node:net';
+let activeServer = null;
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port, '127.0.0.1');
+    });
+}
+function waitForPort(port, timeoutMs = 30000) {
+    const start = Date.now();
+    return new Promise((resolve) => {
+        const check = async () => {
+            const available = await isPortAvailable(port);
+            if (!available) {
+                resolve(true); // port is in use = server is ready
+                return;
+            }
+            if (Date.now() - start > timeoutMs) {
+                resolve(false); // timeout
+                return;
+            }
+            setTimeout(check, 500);
+        };
+        check();
+    });
+}
+async function startServer(projectDir, devCommand, port) {
+    // If already running, return current status
+    if (activeServer) {
+        const isRunning = activeServer.process.exitCode === null;
+        if (isRunning) {
+            return {
+                url: activeServer.url,
+                port: activeServer.port,
+                pid: activeServer.process.pid || 0,
+                ready: true,
+                startedAt: new Date(activeServer.startTime).toISOString(),
+            };
+        }
+        // Process died, clean up
+        activeServer = null;
+    }
+    // Check if port is already in use (server running externally)
+    const portAvailable = await isPortAvailable(port);
+    if (!portAvailable) {
+        return {
+            url: `http://localhost:${port}`,
+            port,
+            pid: 0,
+            ready: true,
+            startedAt: new Date().toISOString(),
+        };
+    }
+    // Determine shell command
+    const isWin = process.platform === 'win32';
+    const shellCmd = isWin ? `cmd /c "${devCommand}"` : devCommand;
+    const child = spawn(shellCmd, [], {
+        cwd: projectDir,
+        shell: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        windowsHide: true,
+    });
+    child.stdout?.on('data', (data) => {
+        // Optionally log or filter output
+        const text = data.toString();
+        // Vite prints local URL on stdout
+        if (text.includes('Local:')) {
+            const urlMatch = text.match(/http:\/\/localhost:\d+/);
+            if (urlMatch) {
+                // URL is confirmed
+            }
+        }
+    });
+    child.stderr?.on('data', (data) => {
+        // Some frameworks output to stderr
+    });
+    child.on('error', (err) => {
+        activeServer = null;
+        throw new Error(`Failed to start dev server: ${err.message}`);
+    });
+    child.on('exit', (code) => {
+        if (activeServer?.process === child) {
+            activeServer = null;
+        }
+    });
+    // Wait for port to be ready
+    const ready = await waitForPort(port, 30000);
+    if (!ready) {
+        // Kill the process if it didn't start in time
+        child.kill();
+        throw new Error(`Dev server did not start within 30 seconds on port ${port}`);
+    }
+    const url = `http://localhost:${port}`;
+    activeServer = {
+        process: child,
+        port,
+        url,
+        startTime: Date.now(),
+    };
+    return {
+        url,
+        port,
+        pid: child.pid || 0,
+        ready: true,
+        startedAt: new Date().toISOString(),
+    };
+}
+async function stopServer() {
+    if (!activeServer) {
+        return { success: true, message: 'No active dev server to stop.' };
+    }
+    const child = activeServer.process;
+    const port = activeServer.port;
+    try {
+        // Try graceful shutdown first
+        const isWin = process.platform === 'win32';
+        if (isWin) {
+            spawn('taskkill', ['/pid', String(child.pid), '/f', '/t']);
+        }
+        else {
+            child.kill('SIGTERM');
+        }
+        // Wait for process to exit
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                child.kill('SIGKILL');
+                resolve();
+            }, 5000);
+            child.on('exit', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+        activeServer = null;
+        return {
+            success: true,
+            message: `Dev server on port ${port} stopped.`,
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            message: `Failed to stop dev server: ${errorMessage}`,
+        };
+    }
+}
+function getServerStatus() {
+    if (!activeServer)
+        return null;
+    return {
+        url: activeServer.url,
+        port: activeServer.port,
+        pid: activeServer.process.pid || 0,
+        ready: activeServer.process.exitCode === null,
+        startedAt: new Date(activeServer.startTime).toISOString(),
+    };
+}
+export { startServer, stopServer, getServerStatus };
+//# sourceMappingURL=serverManager.js.map

package/dist/serverManager.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export interface ProjectInfo {
+    framework: 'vite' | 'nextjs' | 'vue-cli' | 'cra' | 'webpack' | 'unknown';
+    port: number;
+    devCommand: string;
+    devScript: string;
+    projectName: string;
+    hasNodeModules: boolean;
+    npmScripts: Record<string, string>;
+}
+export interface ServerStatus {
+    url: string;
+    port: number;
+    pid: number;
+    ready: boolean;
+    startedAt: string;
+}
+export interface MCPToolResponse {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    [key: string]: unknown;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@sudu-cli/fronted-preview-mcp",
+  "version": "1.0.0-beta.0",
+  "description": "MCP server for frontend project detection, dev server management, and preview workflow. Pairs with chrome-devtools-mcp for automated frontend checking.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "fronted-preview-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "frontend",
+    "preview",
+    "opencode",
+    "claude-code",
+    "vite",
+    "nextjs",
+    "dev-server"
+  ]
+}

package/templates/init/agent.md

@@ -0,0 +1,31 @@
+---
+description: 前端页面预览检查专家，自动检测 console 错误和渲染问题
+mode: subagent
+permission:
+  edit: deny
+  bash: deny
+---
+
+你是一个前端页面检查专家，专注于自动预览前端页面并报告问题。
+
+## 工作流程
+
+1. 调用 `quick_preview` 检测框架并启动 dev server
+2. 用 chrome-devtools `navigate_page` 打开返回的 URL
+3. 用 `list_console_messages` 检查 console 错误
+4. 用 `take_snapshot` 获取页面结构分析
+5. 汇总结果给用户
+
+## 工具路由
+
+| 场景 | 工具序列 |
+|------|---------|
+| "检查页面效果" | quick_preview → navigate_page → list_console_messages → take_snapshot |
+| "只看项目信息" | get_project_info（不启动服务） |
+| "停止 dev server" | stop_dev_server |
+
+## 注意
+
+- 不需要截图，take_snapshot 就够了
+- quick_preview 已包含检测，不要再调 get_project_info
+- 报告结果时说明：是否正常运行、是否有错误、页面结构

package/templates/init/instructions.md

@@ -0,0 +1,33 @@
+# Frontend Preview Workflow
+
+本项目已配置 `frontend-preview` + `chrome-devtools` MCP 服务器。
+你可以用自然语言描述前端页面查看需求，AI 会自动使用下面的工作流。
+
+## 页面预览检查工作流
+
+当用户想"检查页面效果"、"预览页面"、"看看页面有什么问题"时，按照以下步骤：
+
+1. **`quick_preview`** — 检测框架 + 启动 dev server，一步完成
+2. **chrome-devtools `navigate_page`** — 在浏览器中打开页面 URL
+3. **chrome-devtools `list_console_messages`** — 检查 console 错误
+4. **chrome-devtools `take_snapshot`** — 获取页面无障碍结构树，分析渲染
+5. **汇总结果** — 告诉用户：页面运行状态、有无 console 错误、页面结构概况
+
+## 工具快速参考
+
+| 工具 | 用途 | 优先使用场景 |
+|------|------|------------|
+| `quick_preview` | 检测框架 + 启动 dev server | 大多数场景——一步到位 |
+| `get_project_info` | 仅检测框架信息 | 用户只问"这是什么项目" |
+| `start_dev_server` | 仅启动 dev server | 已知道框架时单独使用 |
+| `stop_dev_server` | 停止 dev server | 用户明确要求停止 |
+| chrome-devtools `navigate_page` | 打开 URL | 拿到 URL 后立即使用 |
+| chrome-devtools `list_console_messages` | 检查 console 错误 | 页面加载完成后 |
+| chrome-devtools `take_snapshot` | 获取页面结构 | 需要分析渲染结果时 |
+| chrome-devtools `take_screenshot` | 页面截图 | 用户明确要求视觉确认时 |
+
+## 注意
+
+- 默认不需要截图，`take_snapshot` 的无障碍树对 AI 已足够
+- `quick_preview` 已包含 framework 检测，不要再重复调 `get_project_info`
+- dev server 可以保持运行，不需要每次用完就关闭

package/templates/init/opencode.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "frontend-preview": {
+      "type": "local",
+      "command": ["npx", "-y", "@sudu-cli/fronted-preview-mcp"]
+    },
+    "chrome-devtools": {
+      "type": "local",
+      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
+    }
+  },
+  "instructions": [".opencode/frontend-preview/instructions.md"]
+}