@search-docs/mcp-server 1.0.14 → 1.0.15

package/dist/__tests__/server-state-transition-v2.test.js

@@ -0,0 +1,182 @@
+/**
+ * MCP Server 状態遷移とライフサイクル E2E Tests (リファクタリング版)
+ *
+ * テストヘルパーを使用して、各状態のテストを明確に分離
+ */
+import { describe, test, expect, afterEach } from 'vitest';
+import { setupTestEnvironment } from './helpers/test-setup.js';
+describe('MCP Server 状態遷移テスト (リファクタリング版)', () => {
+    let env = null;
+    afterEach(async () => {
+        if (env) {
+            await env.cleanup();
+            env = null;
+        }
+    });
+    describe('NOT_CONFIGURED状態', () => {
+        test('未設定状態で利用可能なツールはinit, get_system_statusのみ', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'not-configured',
+                createConfig: false,
+            });
+            const response = (await env.tester.sendRequest('tools/list', {}));
+            const toolNames = response.tools.map((t) => t.name);
+            // NOT_CONFIGURED状態では init と get_system_status のみ利用可能
+            expect(toolNames).toContain('init');
+            expect(toolNames).toContain('get_system_status');
+            // 他のツールは利用不可
+            expect(toolNames).not.toContain('search');
+            expect(toolNames).not.toContain('get_document');
+            expect(toolNames).not.toContain('index_status');
+        });
+        test('get_system_statusで未設定状態を確認', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'not-configured',
+                createConfig: false,
+            });
+            const result = await env.tester.callTool('get_system_status', {});
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toBeDefined();
+            expect(content).toContain('状態: 未設定');
+        });
+        test('initツールで設定ファイルを作成', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'not-configured',
+                createConfig: false,
+            });
+            const result = await env.tester.callTool('init', {
+                port: 54321,
+            });
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toContain('✅ 設定ファイルの初期化が完了しました');
+            expect(content).toContain('📝 設定ファイルの重要な項目');
+        });
+    });
+    describe('CONFIGURED_SERVER_DOWN状態', () => {
+        test('設定済み・サーバ停止状態で利用可能なツール', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'configured-down',
+                createConfig: true,
+                port: 54322,
+                createIndexDir: false, // インデックスなし = auto-startしない
+            });
+            const response = (await env.tester.sendRequest('tools/list', {}));
+            const toolNames = response.tools.map((t) => t.name);
+            // CONFIGURED_SERVER_DOWN状態では server_start, server_stop も利用可能
+            expect(toolNames).toContain('init');
+            expect(toolNames).toContain('server_start');
+            expect(toolNames).toContain('server_stop');
+            expect(toolNames).toContain('get_system_status');
+            // 検索系ツールは利用不可
+            expect(toolNames).not.toContain('search');
+            expect(toolNames).not.toContain('get_document');
+            expect(toolNames).not.toContain('index_status');
+        });
+        test('get_system_statusで設定済み・サーバ停止状態を確認', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'configured-down',
+                createConfig: true,
+                port: 54323,
+                createIndexDir: false,
+            });
+            const result = await env.tester.callTool('get_system_status', {});
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toContain('状態: 設定済み・サーバ停止中');
+        });
+    });
+    describe('RUNNING状態（auto-start）', () => {
+        test('インデックス存在時にauto-startで全ツールが利用可能', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'running-auto',
+                createConfig: true,
+                port: 54324,
+                createIndexDir: true, // インデックスあり = auto-start
+            });
+            const response = (await env.tester.sendRequest('tools/list', {}));
+            const toolNames = response.tools.map((t) => t.name);
+            // RUNNING状態では全ツールが利用可能
+            expect(toolNames).toContain('init');
+            expect(toolNames).toContain('server_start');
+            expect(toolNames).toContain('server_stop');
+            expect(toolNames).toContain('get_system_status');
+            expect(toolNames).toContain('search');
+            expect(toolNames).toContain('get_document');
+            expect(toolNames).toContain('index_status');
+        }, 40000); // 40秒のタイムアウト（auto-start health check 30s + buffer）
+        test('get_system_statusで稼働中状態を確認', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'running-auto',
+                createConfig: true,
+                port: 54325,
+                createIndexDir: true,
+            });
+            const result = await env.tester.callTool('get_system_status', {});
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toContain('状態: 稼働中');
+            expect(content).toContain('サーバURL:');
+        }, 40000); // 40秒のタイムアウト（auto-start health check 30s + buffer）
+    });
+    describe('サーバ起動・停止のライフサイクル', () => {
+        test('server_startでサーバを起動し、server_stopで停止できる', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'lifecycle',
+                createConfig: true,
+                port: 54326,
+                createIndexDir: false,
+            });
+            // 1. サーバを起動
+            const startResult = await env.tester.callTool('server_start', {});
+            expect(startResult.success).toBe(true);
+            const startContent = startResult.result?.content?.[0]?.text;
+            expect(startContent).toContain('✅ サーバを起動しました');
+            // サーバ起動を待機
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            // 2. 起動後の状態確認
+            const statusAfterStart = await env.tester.callTool('get_system_status', {});
+            const statusContent = statusAfterStart.result?.content?.[0]?.text;
+            expect(statusContent).toContain('状態: 稼働中');
+            // 3. サーバを停止
+            const stopResult = await env.tester.callTool('server_stop', {});
+            expect(stopResult.success).toBe(true);
+            const stopContent = stopResult.result?.content?.[0]?.text;
+            expect(stopContent).toContain('✅ サーバを停止しました');
+            // サーバ停止を待機
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            // 4. 停止後の状態確認
+            const statusAfterStop = await env.tester.callTool('get_system_status', {});
+            const statusAfterStopContent = statusAfterStop.result?.content?.[0]
+                ?.text;
+            expect(statusAfterStopContent).toContain('状態: 設定済み・サーバ停止中');
+        }, 30000); // 30秒のタイムアウト
+        test('停止後に再度server_startで起動できる', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'lifecycle-restart',
+                createConfig: true,
+                port: 54327,
+                createIndexDir: false,
+            });
+            // 1. 初回起動
+            await env.tester.callTool('server_start', {});
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            // 2. 停止
+            await env.tester.callTool('server_stop', {});
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            // 3. 再起動
+            const restartResult = await env.tester.callTool('server_start', {});
+            expect(restartResult.success).toBe(true);
+            const restartContent = restartResult.result?.content?.[0]?.text;
+            expect(restartContent).toContain('✅ サーバを起動しました');
+            // 再起動を待機
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            // 4. 再起動後の状態確認
+            const statusAfterRestart = await env.tester.callTool('get_system_status', {});
+            const statusContent = statusAfterRestart.result?.content?.[0]?.text;
+            expect(statusContent).toContain('状態: 稼働中');
+        }, 40000); // 40秒のタイムアウト
+    });
+});
+//# sourceMappingURL=server-state-transition-v2.test.js.map

package/dist/__tests__/server-state-transition-v2.test.js.map

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

package/dist/__tests__/server-state.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Server 状態確認テスト
+ *
+ * 目的: 各状態（NOT_CONFIGURED, CONFIGURED_SERVER_DOWN, RUNNING）において、
+ *       利用可能なツールとget_system_statusの内容が正しいかを確認する。
+ *
+ * 特徴: search-docsサーバを起動/停止しない静的なテスト
+ *       各テストは独立した一時ディレクトリとポート番号を使用
+ */
+export {};
+//# sourceMappingURL=server-state.test.d.ts.map

package/dist/__tests__/server-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-state.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/server-state.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/server-state.test.js

@@ -0,0 +1,123 @@
+/**
+ * MCP Server 状態確認テスト
+ *
+ * 目的: 各状態（NOT_CONFIGURED, CONFIGURED_SERVER_DOWN, RUNNING）において、
+ *       利用可能なツールとget_system_statusの内容が正しいかを確認する。
+ *
+ * 特徴: search-docsサーバを起動/停止しない静的なテスト
+ *       各テストは独立した一時ディレクトリとポート番号を使用
+ */
+import { describe, test, expect, afterEach } from 'vitest';
+import { setupTestEnvironment } from './helpers/test-setup.js';
+describe('MCP Server 状態確認テスト', () => {
+    let env = null;
+    afterEach(async () => {
+        if (env) {
+            await env.cleanup();
+            env = null;
+        }
+    });
+    describe('NOT_CONFIGURED状態', () => {
+        test('利用可能なツールはinit, get_system_statusのみ', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'state-not-configured',
+                createConfig: false,
+                port: 54320,
+            });
+            const response = (await env.tester.sendRequest('tools/list', {}));
+            const toolNames = response.tools.map((t) => t.name);
+            // NOT_CONFIGURED状態では init と get_system_status のみ利用可能
+            expect(toolNames).toContain('init');
+            expect(toolNames).toContain('get_system_status');
+            // 他のツールは利用不可
+            expect(toolNames).not.toContain('server_start');
+            expect(toolNames).not.toContain('server_stop');
+            expect(toolNames).not.toContain('search');
+            expect(toolNames).not.toContain('get_document');
+            expect(toolNames).not.toContain('index_status');
+        });
+        test('get_system_statusで未設定状態を確認', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'state-not-configured-status',
+                createConfig: false,
+                port: 54320,
+            });
+            const result = await env.tester.callTool('get_system_status', {});
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toBeDefined();
+            expect(content).toContain('状態: 未設定');
+        });
+    });
+    describe('CONFIGURED_SERVER_DOWN状態', () => {
+        test('利用可能なツールはserver_start, server_stopなどが追加', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'state-configured-down',
+                createConfig: true,
+                port: 54321,
+                createIndexDir: false, // インデックスなし = auto-startしない
+            });
+            const response = (await env.tester.sendRequest('tools/list', {}));
+            const toolNames = response.tools.map((t) => t.name);
+            // CONFIGURED_SERVER_DOWN状態では server_start, server_stop も利用可能
+            expect(toolNames).toContain('init');
+            expect(toolNames).toContain('server_start');
+            expect(toolNames).toContain('server_stop');
+            expect(toolNames).toContain('get_system_status');
+            // 検索系ツールは利用不可
+            expect(toolNames).not.toContain('search');
+            expect(toolNames).not.toContain('get_document');
+            expect(toolNames).not.toContain('index_status');
+        });
+        test('get_system_statusで設定済み・サーバ停止中状態を確認', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'state-configured-down-status',
+                createConfig: true,
+                port: 54321,
+                createIndexDir: false,
+            });
+            const result = await env.tester.callTool('get_system_status', {});
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toContain('状態: 設定済み・サーバ停止中');
+        });
+    });
+    describe('RUNNING状態（auto-start後）', () => {
+        test('全ツールが利用可能', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'state-running',
+                createConfig: true,
+                port: 54322,
+                createIndexDir: true, // インデックスあり = auto-start
+            });
+            // auto-start完了を待機
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            const response = (await env.tester.sendRequest('tools/list', {}));
+            const toolNames = response.tools.map((t) => t.name);
+            // RUNNING状態では全ツールが利用可能
+            expect(toolNames).toContain('init');
+            expect(toolNames).toContain('server_start');
+            expect(toolNames).toContain('server_stop');
+            expect(toolNames).toContain('get_system_status');
+            expect(toolNames).toContain('search');
+            expect(toolNames).toContain('get_document');
+            expect(toolNames).toContain('index_status');
+        }, 40000); // 40秒のタイムアウト（auto-start health check 30s + buffer）
+        test('get_system_statusで稼働中状態を確認', async () => {
+            env = await setupTestEnvironment({
+                prefix: 'state-running-status',
+                createConfig: true,
+                port: 54322,
+                createIndexDir: true,
+            });
+            // auto-start完了を待機
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            const result = await env.tester.callTool('get_system_status', {});
+            expect(result.success).toBe(true);
+            const content = result.result?.content?.[0]?.text;
+            expect(content).toContain('状態: 稼働中');
+            expect(content).toContain('サーバURL:');
+        }, 40000); // 40秒のタイムアウト（auto-start health check 30s + buffer）
+    });
+});
+//# sourceMappingURL=server-state.test.js.map

package/dist/__tests__/server-state.test.js.map

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

package/dist/__tests__/state.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 状態管理のテスト
+ */
+export {};
+//# sourceMappingURL=state.test.d.ts.map

package/dist/__tests__/state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/state.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/state.test.js

@@ -0,0 +1,114 @@
+/**
+ * 状態管理のテスト
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { detectSystemState, getStateErrorMessage } from '../state.js';
+import { ConfigLoader } from '@search-docs/types';
+import { SearchDocsClient } from '@search-docs/client';
+// モック
+vi.mock('@search-docs/types');
+vi.mock('@search-docs/client');
+describe('state', () => {
+    describe('detectSystemState', () => {
+        beforeEach(() => {
+            vi.clearAllMocks();
+        });
+        it('設定ファイルがない場合、NOT_CONFIGUREDを返す', async () => {
+            // ConfigLoader.resolve が設定なしを返す
+            vi.mocked(ConfigLoader.resolve).mockResolvedValue({
+                config: null,
+                configPath: null,
+                projectRoot: '/test/project',
+            });
+            const result = await detectSystemState('/test/project');
+            expect(result.state).toBe('NOT_CONFIGURED');
+            expect(result.projectRoot).toBe('/test/project');
+            expect(result.config).toBeUndefined();
+            expect(result.configPath).toBeUndefined();
+        });
+        it('設定ファイル読み込みエラーの場合、NOT_CONFIGUREDを返す', async () => {
+            // ConfigLoader.resolve がエラーを投げる
+            vi.mocked(ConfigLoader.resolve).mockRejectedValue(new Error('Configuration file not found'));
+            const result = await detectSystemState('/test/project');
+            expect(result.state).toBe('NOT_CONFIGURED');
+            expect(result.projectRoot).toBe('/test/project');
+        });
+        it('設定ファイルがあるがサーバが停止中の場合、CONFIGURED_SERVER_DOWNを返す', async () => {
+            const mockConfig = {
+                version: '1.0',
+                server: {
+                    host: 'localhost',
+                    port: 24280,
+                    protocol: 'json-rpc',
+                },
+            };
+            // ConfigLoader.resolve が設定を返す
+            vi.mocked(ConfigLoader.resolve).mockResolvedValue({
+                config: mockConfig,
+                configPath: '/test/project/.search-docs.json',
+                projectRoot: '/test/project',
+            });
+            // SearchDocsClient.healthCheck がエラーを投げる（サーバ停止中）
+            const mockHealthCheck = vi.fn().mockRejectedValue(new Error('Connection refused'));
+            vi.mocked(SearchDocsClient).mockImplementation(class {
+                healthCheck = mockHealthCheck;
+            });
+            const result = await detectSystemState('/test/project');
+            expect(result.state).toBe('CONFIGURED_SERVER_DOWN');
+            expect(result.config).toBe(mockConfig);
+            expect(result.configPath).toBe('/test/project/.search-docs.json');
+            expect(result.projectRoot).toBe('/test/project');
+            expect(result.serverUrl).toBe('http://localhost:24280');
+            expect(result.client).toBeUndefined();
+        });
+        it('設定ファイルがありサーバが稼働中の場合、RUNNINGを返す', async () => {
+            const mockConfig = {
+                version: '1.0',
+                server: {
+                    host: 'localhost',
+                    port: 24280,
+                    protocol: 'json-rpc',
+                },
+            };
+            // ConfigLoader.resolve が設定を返す
+            vi.mocked(ConfigLoader.resolve).mockResolvedValue({
+                config: mockConfig,
+                configPath: '/test/project/.search-docs.json',
+                projectRoot: '/test/project',
+            });
+            // SearchDocsClient.healthCheck が成功（サーバ稼働中）
+            const mockHealthCheck = vi.fn().mockResolvedValue(undefined);
+            vi.mocked(SearchDocsClient).mockImplementation(class {
+                healthCheck = mockHealthCheck;
+            });
+            const result = await detectSystemState('/test/project');
+            expect(result.state).toBe('RUNNING');
+            expect(result.config).toBe(mockConfig);
+            expect(result.configPath).toBe('/test/project/.search-docs.json');
+            expect(result.projectRoot).toBe('/test/project');
+            expect(result.serverUrl).toBe('http://localhost:24280');
+            expect(result.client).toBeDefined();
+        });
+    });
+    describe('getStateErrorMessage', () => {
+        it('NOT_CONFIGURED状態のエラーメッセージを返す', () => {
+            const message = getStateErrorMessage('NOT_CONFIGURED', '検索');
+            expect(message).toContain('検索を実行できません');
+            expect(message).toContain('セットアップされていません');
+            expect(message).toContain('init');
+            expect(message).toContain('server_start');
+        });
+        it('CONFIGURED_SERVER_DOWN状態のエラーメッセージを返す', () => {
+            const message = getStateErrorMessage('CONFIGURED_SERVER_DOWN', '検索');
+            expect(message).toContain('検索を実行できません');
+            expect(message).toContain('起動していません');
+            expect(message).toContain('server_start');
+        });
+        it('RUNNING状態のエラーメッセージを返す', () => {
+            const message = getStateErrorMessage('RUNNING', '検索');
+            expect(message).toContain('検索を実行できません');
+            expect(message).toContain('予期しないエラー');
+        });
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/__tests__/state.test.js.map

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

package/dist/server-manager.d.ts

@@ -11,7 +11,7 @@ export declare class ServerManager {
      */
     private resolveCliPath;
     /**
-     * サーバを起動
+     * サーバを起動（デーモンモード）
      */
     startServer(projectDir: string, port: number, configPath?: string): Promise<void>;
     /**

package/dist/server-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../src/server-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAA8B;IAEnD;;OAEG;YACW,cAAc;IA0B5B;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DvF;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../src/server-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAA8B;IAEnD;;OAEG;YACW,cAAc;IAqB5B;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyHvF;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/server-manager.js

@@ -4,6 +4,7 @@
 import { spawn } from 'child_process';
 import * as path from 'path';
 import * as fs from 'fs/promises';
+import { SearchDocsClient } from '@search-docs/client';
 /**
  * サーバマネージャー
  */
@@ -15,13 +16,10 @@ export class ServerManager {
     async resolveCliPath() {
         try {
             // import.meta.resolve()でパスを解決
+            // これはパッケージのエントリポイント（package.jsonのmainフィールド）を返す
             const cliPackage = import.meta.resolve('@search-docs/cli');
             // file:// プロトコルを削除してファイルパスに変換
-            const cliPackagePath = cliPackage.replace(/^file:\/\//, '');
-            // パッケージディレクトリを取得
-            const cliDir = path.dirname(cliPackagePath);
-            // dist/index.jsを探す
-            const cliEntryPoint = path.join(cliDir, 'dist', 'index.js');
+            const cliEntryPoint = cliPackage.replace(/^file:\/\//, '');
             // ファイルが存在するか確認
             await fs.access(cliEntryPoint);
             return cliEntryPoint;
@@ -32,25 +30,37 @@ export class ServerManager {
         }
     }
     /**
-     * サーバを起動
+     * サーバを起動（デーモンモード）
      */
     async startServer(projectDir, port, configPath) {
+        console.error('[mcp-server] ========================================');
         console.error('[mcp-server] Starting search-docs server...');
+        console.error('[mcp-server] Input parameters:');
+        console.error(`[mcp-server]   - projectDir: ${projectDir}`);
+        console.error(`[mcp-server]   - port: ${port}`);
+        console.error(`[mcp-server]   - configPath: ${configPath || '(not provided)'}`);
         try {
             // CLIのエントリポイントを解決
             const cliPath = await this.resolveCliPath();
             console.error(`[mcp-server] CLI path resolved: ${cliPath}`);
-            // サーバ起動コマンドを構築
-            const args = ['server', 'start', '--foreground', '--port', port.toString()];
+            // サーバ起動コマンドを構築（デーモンモード）
+            const args = ['server', 'start', '--port', port.toString()];
             if (configPath) {
                 args.push('--config', configPath);
             }
-            // サーバを起動
+            console.error('[mcp-server] Spawn parameters:');
+            console.error(`[mcp-server]   - command: node`);
+            console.error(`[mcp-server]   - args: ${JSON.stringify([cliPath, ...args])}`);
+            console.error(`[mcp-server]   - cwd: ${projectDir}`);
+            console.error(`[mcp-server]   - stdio: ['ignore', 'pipe', 'pipe']`);
+            console.error(`[mcp-server]   - detached: false`);
+            // サーバを起動（デーモンモード）
             const serverProcess = spawn('node', [cliPath, ...args], {
                 cwd: projectDir, // プロジェクトディレクトリで実行
                 stdio: ['ignore', 'pipe', 'pipe'], // stdin無視, stdout/stderrキャプチャ
-                detached: false, // MCP終了時にサーバも終了
+                detached: false,
             });
+            console.error(`[mcp-server] Process spawned with PID: ${serverProcess.pid || '(unknown)'}`);
             // エラーハンドリング
             serverProcess.on('error', (error) => {
                 console.error(`[mcp-server] Server process error: ${error.message}`);
@@ -65,16 +75,59 @@ export class ServerManager {
             });
             // プロセス終了時
             serverProcess.on('exit', (code, signal) => {
-                console.error(`[mcp-server] Server process exited: code=${code}, signal=${signal}`);
-                this.serverProcess = null;
+                console.error(`[mcp-server] Server launcher exited: code=${code}, signal=${signal}`);
             });
+            // デーモンモードなので、起動プロセスは即座に終了する
+            // 実際のサーバプロセスは別プロセスとして起動される
             this.serverProcess = {
                 process: serverProcess,
                 port,
             };
-            // サーバの起動を待つ（簡易的に2秒待機）
-            await new Promise(resolve => setTimeout(resolve, 2000));
-            console.error('[mcp-server] Server started successfully');
+            // デーモンモードでは起動プロセスが即座に終了するため、
+            // 実際のサーバプロセスが起動完了するまで待機する
+            console.error('[mcp-server] Waiting for server to start...');
+            // サーバのヘルスチェックを行う（最大30秒待機）
+            const serverUrl = `http://localhost:${port}`;
+            const client = new SearchDocsClient({ baseUrl: serverUrl });
+            const maxWaitTime = 30000; // 30秒
+            const checkInterval = 1000; // 1秒
+            let waited = 0;
+            let serverReady = false;
+            console.error(`[mcp-server] Health check target: ${serverUrl}`);
+            console.error(`[mcp-server] Max wait time: ${maxWaitTime}ms, check interval: ${checkInterval}ms`);
+            while (waited < maxWaitTime) {
+                try {
+                    console.error(`[mcp-server] Health check attempt (waited: ${waited}ms)...`);
+                    await client.healthCheck();
+                    serverReady = true;
+                    console.error('[mcp-server] ✓ Server is ready (health check passed)');
+                    break;
+                }
+                catch (error) {
+                    // サーバがまだ起動していない、待機を続ける
+                    console.error(`[mcp-server]   Health check failed: ${error.message}`);
+                    await new Promise(resolve => setTimeout(resolve, checkInterval));
+                    waited += checkInterval;
+                }
+            }
+            if (!serverReady) {
+                console.error('[mcp-server] ✗ Health check timeout after 30 seconds');
+                throw new Error('Server failed to start within 30 seconds');
+            }
+            // PIDファイルの作成を確認
+            const pidFilePath = path.join(projectDir, '.search-docs', 'server.pid');
+            console.error(`[mcp-server] Checking PID file at: ${pidFilePath}`);
+            try {
+                await fs.access(pidFilePath);
+                const pidContent = await fs.readFile(pidFilePath, 'utf-8');
+                console.error('[mcp-server] ✓ PID file confirmed');
+                console.error(`[mcp-server]   PID file content: ${pidContent.substring(0, 200)}...`);
+            }
+            catch (error) {
+                console.error(`[mcp-server] ✗ Warning: PID file not found: ${error.message}`);
+            }
+            console.error('[mcp-server] Server started successfully (daemon mode)');
+            console.error('[mcp-server] ========================================');
         }
         catch (error) {
             throw new Error(`Failed to start server: ${error.message}`);