chore: unify quickstart tsconfigs with shared base, fix doc drift

- Make examples/{client,server}-quickstart extend @modelcontextprotocol/tsconfig
  instead of carrying standalone compilerOptions. Drop the inline target/lib/
  module/moduleResolution/strict/etc. duplicates; only outDir, rootDir,
  declaration overrides, and workspace paths remain.
- Align docs/{client,server}-quickstart.md tsconfig snippets to ESNext/bundler
  to match what the example projects now compile under.
- Adjust examples/client-quickstart/src/index.ts for the stricter
  noUncheckedIndexedAccess inherited from the shared base.
- Strip leftover .js suffixes from vi.mock / vi.importActual string specifiers
  in packages/client/test/client/middleware.test.ts.

Author: mattzcarey

docs/client-quickstart.md

@@ -90,8 +90,8 @@ Create a `tsconfig.json` in the root of your project:
   "compilerOptions": {
     "target": "ES2023",
     "lib": ["ES2023"],
-    "module": "Node16",
-    "moduleResolution": "Node16",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
     "outDir": "./build",
     "rootDir": "./src",
     "strict": true,
@@ -236,7 +236,8 @@ Now let's add the core functionality for processing queries and handling tool ca
           messages,
         });
 
-        finalText.push(followUp.content[0].type === 'text' ? followUp.content[0].text : '');
+        const firstBlock = followUp.content[0];
+        finalText.push(firstBlock?.type === 'text' ? firstBlock.text : '');
       }
     }
 
@@ -284,13 +285,14 @@ Finally, we'll add the main execution logic:
 
 ```ts source="../examples/client-quickstart/src/index.ts#main"
 async function main() {
-  if (process.argv.length < 3) {
+  const serverScriptPath = process.argv[2];
+  if (!serverScriptPath) {
     console.log('Usage: node build/index.js <path_to_server_script>');
     return;
   }
   const mcpClient = new MCPClient();
   try {
-    await mcpClient.connectToServer(process.argv[2]);
+    await mcpClient.connectToServer(serverScriptPath);
 
     // Check if we have a valid API key to continue
     const apiKey = process.env.ANTHROPIC_API_KEY;

docs/server-quickstart.md

@@ -104,8 +104,8 @@ Create a `tsconfig.json` in the root of your project:
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "Node16",
-    "moduleResolution": "Node16",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
     "outDir": "./build",
     "rootDir": "./src",
     "strict": true,

examples/client-quickstart/package.json

@@ -15,6 +15,7 @@
         "@modelcontextprotocol/client": "workspace:^"
     },
     "devDependencies": {
+        "@modelcontextprotocol/tsconfig": "workspace:^",
         "@types/node": "^24.10.1",
         "typescript": "catalog:devTools"
     }

examples/client-quickstart/src/index.ts

@@ -116,7 +116,8 @@ class MCPClient {
           messages,
         });
 
-        finalText.push(followUp.content[0].type === 'text' ? followUp.content[0].text : '');
+        const firstBlock = followUp.content[0];
+        finalText.push(firstBlock?.type === 'text' ? firstBlock.text : '');
       }
     }
 
@@ -156,13 +157,14 @@ class MCPClient {
 
 //#region main
 async function main() {
-  if (process.argv.length < 3) {
+  const serverScriptPath = process.argv[2];
+  if (!serverScriptPath) {
     console.log('Usage: node build/index.js <path_to_server_script>');
     return;
   }
   const mcpClient = new MCPClient();
   try {
-    await mcpClient.connectToServer(process.argv[2]);
+    await mcpClient.connectToServer(serverScriptPath);
 
     // Check if we have a valid API key to continue
     const apiKey = process.env.ANTHROPIC_API_KEY;

examples/client-quickstart/tsconfig.json

@@ -1,15 +1,10 @@
 {
+    "extends": "@modelcontextprotocol/tsconfig",
     "compilerOptions": {
-        "target": "ES2023",
-        "lib": ["ES2023"],
-        "module": "ESNext",
-        "moduleResolution": "bundler",
         "outDir": "./build",
         "rootDir": "./src",
-        "strict": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
+        "declaration": false,
+        "declarationMap": false,
         "paths": {
             "@modelcontextprotocol/client": ["./node_modules/@modelcontextprotocol/client/src/index.ts"],
             "@modelcontextprotocol/client/stdio": ["./node_modules/@modelcontextprotocol/client/src/stdio.ts"],

examples/server-quickstart/package.json

@@ -15,6 +15,7 @@
         "zod": "catalog:runtimeShared"
     },
     "devDependencies": {
+        "@modelcontextprotocol/tsconfig": "workspace:^",
         "@types/node": "^24.10.1",
         "typescript": "catalog:devTools"
     }

examples/server-quickstart/tsconfig.json

@@ -1,14 +1,10 @@
 {
+    "extends": "@modelcontextprotocol/tsconfig",
     "compilerOptions": {
-        "target": "ES2022",
-        "module": "ESNext",
-        "moduleResolution": "bundler",
         "outDir": "./build",
         "rootDir": "./src",
-        "strict": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
+        "declaration": false,
+        "declarationMap": false,
         "paths": {
             "@modelcontextprotocol/server": ["./node_modules/@modelcontextprotocol/server/src/index.ts"],
             "@modelcontextprotocol/server/stdio": ["./node_modules/@modelcontextprotocol/server/src/stdio.ts"],

packages/client/test/client/middleware.test.ts

@@ -4,8 +4,8 @@ import type { Mocked, MockedFunction, MockInstance } from 'vitest';
 import type { OAuthClientProvider } from '../../src/client/auth';
 import { applyMiddlewares, createMiddleware, withLogging, withOAuth } from '../../src/client/middleware';
 
-vi.mock('../../src/client/auth.js', async () => {
-    const actual = await vi.importActual<typeof import('../../src/client/auth')>('../../src/client/auth.js');
+vi.mock('../../src/client/auth', async () => {
+    const actual = await vi.importActual<typeof import('../../src/client/auth')>('../../src/client/auth');
     return {
         ...actual,
         auth: vi.fn(),