feat: add comprehensive integration test suite with browser automation

- Create /test directory with Vitest + Playwright integration tests
- Automate full build pipeline: use-mcp library → inspector → browser testing
- Implement smart port management to avoid conflicts with existing processes
- Add multiple test modes:
  - `pnpm test`: visible browser (default)
  - `pnpm test:headless`: headless mode
  - `pnpm test:watch`: watch mode for development
  - `pnpm test:debug`: hanging process reporter
- Test state management via cache directory (git-ignored)
- Process group cleanup with signal handling for robust teardown
- Simple HTTP server instead of Express to minimize hanging connections
- Full end-to-end validation of MCP server connections and tool discovery

Tests successfully validate:
- Library builds correctly
- Inspector interface loads in browser
- MCP server connections work end-to-end
- Tool discovery and availability verification

Author: geelen

test/integration/mcp-connection.test.ts

@@ -149,6 +149,17 @@ describe('MCP Connection Integration Tests', () => {
     if (browser) {
       await browser.close()
     }
+    
+    // Force cleanup before Vitest exits
+    const state = globalThis.__INTEGRATION_TEST_STATE__
+    if (state?.honoServer && !state.honoServer.killed) {
+      console.log('🔥 Force cleanup before test exit...')
+      state.honoServer.kill('SIGKILL')
+    }
+    if (state?.staticServer) {
+      state.staticServer.close()
+      state.staticServer.closeAllConnections?.()
+    }
   })
 
   beforeEach(async () => {

test/package.json

@@ -10,16 +10,12 @@
     "test:debug": "VITEST_REPORTER=hanging-process vitest --run"
   },
   "dependencies": {
-    "playwright": "^1.49.0",
-    "serve-static": "^1.16.2",
-    "express": "^4.21.2"
+    "playwright": "^1.49.0"
   },
   "devDependencies": {
     "vitest": "^2.1.8",
     "@vitest/ui": "^2.1.8",
     "typescript": "^5.8.2",
-    "@types/node": "^20.17.10",
-    "@types/express": "^5.0.0",
-    "@types/serve-static": "^1.15.7"
+    "@types/node": "^20.17.10"
   }
 }