fix: resolve symlink in isDirectRun check for npx compatibility

The server failed to start when invoked via npx because npm creates
a symlink at .bin/validkit-mcp → dist/index.js. path.resolve() does
not follow symlinks, so process.argv[1] (symlink path) never matched
fileURLToPath(import.meta.url) (real path). Switch to realpathSync()
which resolves symlinks.

Add integration tests that spawn the server via direct node and via
symlink, verifying it responds to MCP initialize in both cases.

Bump version to 1.1.1.

Author: jesse-validkit

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@validkit/mcp-server",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Model Context Protocol (MCP) server for ValidKit email validation - works with Claude Code, Cursor, Windsurf, and any MCP-compatible AI assistant",
   "main": "dist/index.js",
   "type": "module",

src/index.test.ts

@@ -485,7 +485,7 @@ describe('ValidKit MCP Server', () => {
         expect.objectContaining({
           headers: expect.objectContaining({
             'X-API-Key': 'vk_test_mykey',
-            'User-Agent': 'validkit-mcp/1.1.0',
+            'User-Agent': 'validkit-mcp/1.1.1',
             'Content-Type': 'application/json',
           }),
         })
@@ -727,4 +727,75 @@ describe('ValidKit MCP Server', () => {
       );
     });
   });
+
+  describe('integration: entrypoint', () => {
+    const MCP_INIT = JSON.stringify({
+      jsonrpc: '2.0',
+      id: 1,
+      method: 'initialize',
+      params: {
+        protocolVersion: '2024-11-05',
+        capabilities: {},
+        clientInfo: { name: 'test', version: '1.0.0' },
+      },
+    });
+
+    async function spawnAndSend(entrypoint: string): Promise<string> {
+      const { spawn } = await import('node:child_process');
+      return new Promise((resolve, reject) => {
+        const child = spawn('node', [entrypoint], {
+          env: { ...process.env, VALIDKIT_API_KEY: 'vk_test_integration' },
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+
+        let stdout = '';
+        child.stdout.on('data', (chunk: Buffer) => {
+          stdout += chunk.toString();
+          // Got a response — kill the server
+          child.kill();
+        });
+
+        child.on('close', () => resolve(stdout));
+        child.on('error', reject);
+
+        const timer = setTimeout(() => {
+          child.kill();
+          reject(new Error('Timed out'));
+        }, 10_000);
+        child.on('close', () => clearTimeout(timer));
+
+        child.stdin.write(MCP_INIT + '\n');
+        child.stdin.end();
+      });
+    }
+
+    it('starts and responds to MCP initialize when invoked directly', async () => {
+      const { join } = await import('node:path');
+      const distIndex = join(process.cwd(), 'dist', 'index.js');
+
+      const output = await spawnAndSend(distIndex);
+      const response = JSON.parse(output.trim());
+      expect(response.result.serverInfo.name).toBe('validkit');
+      expect(response.result.serverInfo.version).toBe('1.1.1');
+    });
+
+    it('starts and responds when invoked via symlink (npx simulation)', async () => {
+      const { join } = await import('node:path');
+      const { symlinkSync, unlinkSync } = await import('node:fs');
+      const { tmpdir } = await import('node:os');
+
+      const distIndex = join(process.cwd(), 'dist', 'index.js');
+      const symlink = join(tmpdir(), `validkit-mcp-test-${Date.now()}`);
+      symlinkSync(distIndex, symlink);
+
+      try {
+        const output = await spawnAndSend(symlink);
+        const response = JSON.parse(output.trim());
+        expect(response.result.serverInfo.name).toBe('validkit');
+        expect(response.result.serverInfo.version).toBe('1.1.1');
+      } finally {
+        unlinkSync(symlink);
+      }
+    });
+  });
 });

src/index.ts

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { resolve } from 'node:path';
+import { realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 
-export const VERSION = '1.1.0';
+export const VERSION = '1.1.1';
 const REQUEST_TIMEOUT_MS = 30_000;
 
 export function formatCatchError(error: unknown, prefix: string): string {
@@ -280,7 +280,8 @@ async function main() {
 }
 
 const currentFile = fileURLToPath(import.meta.url);
-const isDirectRun = process.argv[1] && resolve(process.argv[1]) === currentFile;
+const isDirectRun =
+  process.argv[1] && realpathSync(process.argv[1]) === currentFile;
 
 if (isDirectRun) {
   main().catch((error) => {