stop_dev_server
Stop npm run dev processes managed by the npm-dev-mcp server. Specify a directory to target specific projects when multiple processes are running.
Instructions
npm run devプロセス停止
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "stop_dev_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| directory | No | 停止対象のディレクトリ(複数起動時に指定。未指定時は唯一のプロセスまたはエラー) |
Implementation Reference
- src/tools/stopDevServer.ts:22-79 (handler)The primary handler function for the 'stop_dev_server' MCP tool. It checks for the target process, stops it using ProcessManager, collects log stats, and returns a detailed JSON response.
export async function stopDevServer(args: { directory?: string }): Promise<string> { try { const processManager = ProcessManager.getInstance(); // Check if target process exists BEFORE stopping const targetProcess = processManager.getProcess(args.directory); if (!targetProcess) { return JSON.stringify({ success: false, message: '指定されたディレクトリのDev serverは見つかりませんでした(または起動していません)', wasRunning: false }); } logger.info('Stopping dev server', { directory: targetProcess.directory }); const logManager = processManager.getLogManager(targetProcess.directory); const finalLogStats = logManager?.getLogStats(); // Stop the dev server const stopResult = await processManager.stopDevServer(args.directory); const result: any = { success: stopResult, message: stopResult ? 'Dev serverを正常に停止しました' : 'Dev serverの停止中にエラーが発生しましたが、プロセスは終了した可能性があります', wasRunning: true, stoppedProcess: { pid: targetProcess.pid, directory: targetProcess.directory, ports: targetProcess.ports } }; if (finalLogStats) { result.finalLogStats = { total: finalLogStats.total, errors: finalLogStats.errors, warnings: finalLogStats.warnings }; if (finalLogStats.errors > 0) { result.message += `\n最終ログに${finalLogStats.errors}個のエラーが記録されています`; } } return JSON.stringify(result, null, 2); } catch (error) { logger.error('Failed to stop dev server', { error }); return JSON.stringify({ success: false, message: `Dev serverの停止に失敗しました: ${error}`, wasRunning: false, error: String(error) }); } } - src/tools/stopDevServer.ts:7-20 (schema)Input schema definition for the 'stop_dev_server' tool, defining the optional 'directory' parameter.
export const stopDevServerSchema: Tool = { name: 'stop_dev_server', description: 'npm run devプロセス停止', inputSchema: { type: 'object', properties: { directory: { type: 'string', description: '停止対象のディレクトリ(複数起動時に指定。未指定時は唯一のプロセスまたはエラー)' } }, additionalProperties: false } }; - src/index.ts:167-175 (registration)Registration and dispatch of the 'stop_dev_server' tool handler in the main CallToolRequestSchema switch statement.
case 'stop_dev_server': return { content: [ { type: 'text', text: await stopDevServer(args as { directory?: string }), }, ], }; - Core helper method in ProcessManager that performs the actual process termination (SIGTERM then SIGKILL if needed) and cleanup, called by the tool handler.
async stopDevServer(directory?: string): Promise<boolean> { this.logger.info(`Stopping dev server${directory ? ` for ${directory}` : ''}`); const targetDirectory = this.resolveTargetDirectory(directory); const processData = this.processes.get(targetDirectory); if (!processData) { this.logger.info(`No dev server running for ${targetDirectory}`); return true; // Already stopped or not found } try { const pid = processData.info.pid; // Try graceful shutdown first if (processData.child) { processData.child.kill('SIGTERM'); } else { await killProcess(pid, 'SIGTERM'); } // Wait a moment for graceful shutdown await new Promise(resolve => setTimeout(resolve, 3000)); // Check if process is still running if (await isProcessRunning(pid)) { this.logger.warn(`Process ${pid} did not stop gracefully, forcing termination`); await killProcess(pid, 'SIGKILL'); } await this.cleanupProcess(targetDirectory); this.logger.info(`Dev server stopped successfully for ${targetDirectory}`); return true; } catch (error) { this.logger.error(`Failed to stop dev server for ${targetDirectory}`, { error }); await this.cleanupProcess(targetDirectory); // Clean up anyway return false; } }