feat: compile example servers to JavaScript for npm consumption (#259)

* feat: compile example servers to JavaScript for npm consumption

Add TypeScript compilation for server code so the example packages can be
imported and used by consumers without requiring TypeScript compilation.

Changes:
- Add tsconfig.server.json to each example for compiling server code
- Update package.json exports to point to compiled dist/server/server.js
- Add types field pointing to dist/server/server.d.ts
- Update build scripts to include server compilation step
- Fix .ts import extensions to .js in customer-segmentation-server

This enables importing the createServer function from published packages:
  import { createServer } from '@modelcontextprotocol/server-basic-react';

* fix: add type assertion for Nominatim API response

* chore: regenerate schemas

* refactor: split server examples into library and binary entry points

- server.ts: exports createServer() only (library entry point)
- main.ts: entry point with main() that runs the server (binary)
- package.json: adds bin field for npx support, uses inline bun build
- tsconfig.server.json: emitDeclarationOnly, outputs to dist/

This allows:
1. Importing the server as a library: import { createServer } from '@modelcontextprotocol/server-basic-react'
2. Running with npx: npx @modelcontextprotocol/server-basic-react [--stdio]

Added migration script at scripts/migrate-server-examples.ts

* refactor: migrate remaining server examples to library/binary structure

Apply the same refactoring to all 13 remaining server examples:
- scenario-modeler-server, shadertoy-server, map-server
- cohort-heatmap-server, customer-segmentation-server, video-resource-server
- system-monitor-server, budget-allocator-server, sheet-music-server
- threejs-server, integration-server, transcript-server, wiki-explorer-server

Each now has:
- server.ts: exports createServer() (library)
- main.ts: runs the server (binary with shebang)
- bin field in package.json for npx support

* chore: remove unused server-utils.ts from video-resource-server/src

* update

* fix(build): make Windows-compatible by removing chmod and fixing bun externals

- Remove 'chmod +x dist/index.js' which doesn't exist on Windows
- Add '--external ./server.js' to prevent bun from treating the import as a second entry point

* fix(build): use .ts import for bun compatibility

- Change import from './server.js' to './server.ts' in main.ts files
- Remove --external flag since bun should inline everything
- Fixes Windows build where bun couldn't resolve .js to .ts properly

* fix(build): use --external for Windows bun compatibility

Bun on Windows incorrectly treats imported .ts files as entry points.
Use --external './server.js' to work around this, creating a runtime
dependency between index.js and server.js.

* style: fix prettier formatting in pdf-server/main.ts

* fix(build): remove quotes from --external for Windows cmd.exe compatibility

* fix(build): use glob pattern for --external to work on all platforms

The literal path --external ./server.js was not matching the import.
Using glob pattern --external "./server*" correctly externalizes the server module.

* fix(build): use */server.js pattern for --external

The "./server*" pattern was not matching on Windows.
Using "*/server.js" matches any path ending in /server.js which works cross-platform.

* fix(build): use *server.js pattern without slash for Windows compatibility

* update package-lock

* chore: regenerate package-lock.json for cross-platform compatibility

* fix(build): use ./server.js instead of glob pattern for Windows compatibility

* fix(build): use double quotes for banner to fix Windows cmd.exe compatibility

---------

Co-authored-by: Olivier Chafik <ochafik@anthropic.com>

examples/pdf-server/server.ts

@@ -13,7 +13,6 @@ import {
   RESOURCE_MIME_TYPE,
 } from "@modelcontextprotocol/ext-apps/server";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import type {
   CallToolResult,
   ReadResourceResult,
@@ -29,7 +28,6 @@ import {
   createEntry,
   isArxivUrl,
   isFileUrl,
-  toFileUrl,
   normalizeArxivUrl,
 } from "./src/pdf-indexer.js";
 import { loadPdfBytesChunk, populatePdfMetadata } from "./src/pdf-loader.js";
@@ -38,7 +36,6 @@ import {
   PdfBytesChunkSchema,
   type PdfIndex,
 } from "./src/types.js";
-import { startServer } from "./server-utils.js";
 
 const DIST_DIR = path.join(import.meta.dirname, "dist");
 const RESOURCE_URI = "ui://pdf-viewer/mcp-app.html";
@@ -46,6 +43,18 @@ const DEFAULT_PDF = "https://arxiv.org/pdf/1706.03762"; // Attention Is All You
 
 let pdfIndex: PdfIndex | null = null;
 
+/**
+ * Initialize the PDF index with the given URLs.
+ * Must be called before createServer().
+ */
+export async function initializePdfIndex(urls: string[]): Promise<void> {
+  pdfIndex = await buildPdfIndex(urls);
+}
+
+/**
+ * Creates a new MCP server instance with tools and resources registered.
+ * Each HTTP session needs its own server instance because McpServer only supports one transport.
+ */
 export function createServer(): McpServer {
   const server = new McpServer({ name: "PDF Server", version: "1.0.0" });
 
@@ -204,51 +213,3 @@ The viewer supports zoom, navigation, text selection, and fullscreen mode.`,
 
   return server;
 }
-
-// CLI
-function parseArgs(): { urls: string[]; stdio: boolean } {
-  const args = process.argv.slice(2);
-  const urls: string[] = [];
-  let stdio = false;
-
-  for (const arg of args) {
-    if (arg === "--stdio") {
-      stdio = true;
-    } else if (!arg.startsWith("-")) {
-      // Convert local paths to file:// URLs, normalize arxiv URLs
-      let url = arg;
-      if (
-        !arg.startsWith("http://") &&
-        !arg.startsWith("https://") &&
-        !arg.startsWith("file://")
-      ) {
-        url = toFileUrl(arg);
-      } else if (isArxivUrl(arg)) {
-        url = normalizeArxivUrl(arg);
-      }
-      urls.push(url);
-    }
-  }
-
-  return { urls: urls.length > 0 ? urls : [DEFAULT_PDF], stdio };
-}
-
-async function main() {
-  const { urls, stdio } = parseArgs();
-
-  console.error(`[pdf-server] Initializing with ${urls.length} PDF(s)...`);
-  pdfIndex = await buildPdfIndex(urls);
-  console.error(`[pdf-server] Ready`);
-
-  if (stdio) {
-    await createServer().connect(new StdioServerTransport());
-  } else {
-    const port = parseInt(process.env.PORT ?? "3001", 10);
-    await startServer(createServer, { port, name: "PDF Server" });
-  }
-}
-
-main().catch((e) => {
-  console.error(e);
-  process.exit(1);
-});