start_dev_server
Run npm run dev in the background within a specified directory using npm-dev-mcp, with automatic project detection and log monitoring for efficient development workflow.
Instructions
指定ディレクトリでnpm run devをバックグラウンドで開始
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| directory | No | 実行ディレクトリ（オプション、未指定時は自動検出） |
Implementation Reference
- src/tools/startDevServer.ts:24-96 (handler)Core handler function that starts the dev server: auto-detects project if no directory provided, loads .env, uses ProcessManager to spawn npm run dev, waits for status, returns JSON with process info and ports.export async function startDevServer(args: { directory?: string }): Promise<string> { try { logger.info('Starting dev server', { directory: args.directory }); let targetDirectory = args.directory; let envPath: string | undefined; // If no directory specified, auto-detect if (!targetDirectory) { const scanner = new ProjectScanner(); const bestProject = await scanner.findBestProject(); if (!bestProject) { return JSON.stringify({ success: false, message: 'devスクリプトが定義されたpackage.jsonが見つかりませんでした。scan_project_dirsを実行して利用可能なプロジェクトを確認してください。' }); } targetDirectory = bestProject.directory; envPath = bestProject.envPath; logger.info(`Auto-detected project directory: ${targetDirectory}`); } // Load environment variables const envLoader = new EnvLoader(); const env = await envLoader.prepareEnvironment(envPath); // Start the dev server const processManager = ProcessManager.getInstance(); const devProcess = await processManager.startDevServer(targetDirectory, env); // Wait a moment to get initial status await new Promise(resolve => setTimeout(resolve, 2000)); const status = await processManager.getStatus(); const result = { success: true, message: 'Dev serverが開始されました', process: { pid: devProcess.pid, directory: devProcess.directory, status: devProcess.status, startTime: devProcess.startTime, ports: devProcess.ports }, environment: { hasEnvFile: !!envPath, envPath, nodeEnv: env.NODE_ENV || 'development' } }; if (devProcess.ports.length > 0) { result.message += `\n起動ポート: ${devProcess.ports.join(', ')}`; } logger.info(`Dev server started successfully`, { pid: devProcess.pid, ports: devProcess.ports }); return JSON.stringify(result, null, 2); } catch (error) { logger.error('Failed to start dev server', { error }); return JSON.stringify({ success: false, message: `Dev serverの開始に失敗しました: ${error}`, error: String(error) }); } }
- src/tools/startDevServer.ts:9-22 (schema)Tool schema defining name, description, and optional 'directory' input parameter.export const startDevServerSchema: Tool = { name: 'start_dev_server', description: '指定ディレクトリでnpm run devをバックグラウンドで開始', inputSchema: { type: 'object', properties: { directory: { type: 'string', description: '実行ディレクトリ（オプション、未指定時は自動検出）' } }, additionalProperties: false } };
- src/index.ts:55-65 (registration)Registration of tool schemas in the tools array used by listToolsRequestHandler.const tools = [ scanProjectDirsSchema, startDevServerSchema, getDevStatusSchema, getDevLogsSchema, stopDevServerSchema, restartDevServerSchema, getHealthStatusSchema, recoverFromStateSchema, autoRecoverSchema, ];
- src/index.ts:137-145 (registration)Dispatch logic in CallToolRequestSchema handler that invokes the startDevServer function.case 'start_dev_server': return { content: [ { type: 'text', text: await startDevServer(args as { directory?: string }), }, ], };
- src/initialization/MCPServerInitializer.ts:15-15 (registration)Dependency registration: requires 'stateManager' service to be initialized before tool execution.'start_dev_server': ['stateManager'],