Closes #1795. Enforce localhost-only binding in code (the "never 0.0.0.0" rule was only a spec note): refuse an all-interfaces HOST — across every spelling the OS binds as the wildcard (inet_aton decimal/octal/hex, IPv6, IPv4-mapped, zone-scoped, IDNA/Unicode) — unless DANGEROUSLY_BIND_ALL_INTERFACES=true (Docker's sanctioned opt-in). Fixes the reported stdio-connect 403 by expanding the default loopback origin allow-list to all three interchangeable forms. Hardening surfaced across an extended review: closes an IDNA/fullwidth wildcard bypass, a blank-ALLOWED_ORIGINS fail-open, and the CLI/TUI OAuth-callback wildcard bind (loopback-only now, RFC 8252); canonicalizes the origin allow-list the way a browser does; derives frame-ancestors from the real embedder list (IPv6-literal exclusion verified in headless Chromium); strictPort on all three bind points; and preserves the CLI exit-code map + JSON envelope through the mcp-inspector --cli launcher path. Shared host normalization lives in core/node/hostUrl.ts. Docs + tests + smokes throughout. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
83 lines
2.9 KiB
TypeScript
83 lines
2.9 KiB
TypeScript
/**
|
|
* Start Vite dev server in-process via the Node API. Config is passed into the plugin; no shared state.
|
|
*
|
|
* Uses the shared base config so Node-only callers don't need to load
|
|
* `vite.config.ts` (which Node can't import directly).
|
|
*/
|
|
|
|
import { join, dirname, resolve } from "node:path";
|
|
import { fileURLToPath } from "node:url";
|
|
import { createServer, type InlineConfig } from "vite";
|
|
import react from "@vitejs/plugin-react";
|
|
import type { WebServerConfig } from "./web-server-config.js";
|
|
import { honoMiddlewarePlugin } from "./vite-hono-plugin.js";
|
|
import {
|
|
clearViteDepsCache,
|
|
getViteDevOptimizeDeps,
|
|
} from "./vite-base-config.js";
|
|
import { vitestSharedPaths } from "../../../vitest.shared.mts";
|
|
import type { WebServerHandle } from "./types.js";
|
|
|
|
export type { WebServerHandle };
|
|
|
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
|
|
/**
|
|
* Start the Vite dev server in-process. Passes config into the plugin. Caller owns SIGINT/SIGTERM.
|
|
*/
|
|
export async function startViteDevServer(
|
|
config: WebServerConfig,
|
|
): Promise<WebServerHandle> {
|
|
// Canonicalize paths under clients/web.
|
|
const root = resolve(join(__dirname, ".."));
|
|
clearViteDepsCache(root);
|
|
// `configFile: false` means this in-process server never loads
|
|
// `vite.config.ts`, so it must reproduce that file's `resolve` block and
|
|
// `server.fs.allow` here. Without them, App.tsx's `@inspector/core/*`
|
|
// imports fail to resolve and the page 500s (#1452 smoke test). The aliases
|
|
// and dedupe are factored into `vitest.shared.mts` so both paths stay in
|
|
// sync — pass the client dir (`root`) so bare-module pins resolve against
|
|
// `clients/web/node_modules`.
|
|
const { repoRoot, sharedAliases, sharedDedupe, nodeModulesAliases } =
|
|
vitestSharedPaths(root);
|
|
const inlineConfig: InlineConfig = {
|
|
optimizeDeps: getViteDevOptimizeDeps(),
|
|
configFile: false,
|
|
root,
|
|
resolve: {
|
|
alias: [
|
|
...Object.entries(sharedAliases).map(([find, replacement]) => ({
|
|
find,
|
|
replacement,
|
|
})),
|
|
...nodeModulesAliases,
|
|
],
|
|
dedupe: sharedDedupe,
|
|
},
|
|
server: {
|
|
port: config.port,
|
|
host: config.hostname,
|
|
// `strictPort: true` (matching `vite.config.ts`) so a busy port fails
|
|
// loudly instead of silently binding a different one — the origin
|
|
// allow-list and the sandbox `frame-ancestors` are derived from
|
|
// `config.port`, so a drifted bind would 403 every connect and CSP-block
|
|
// the MCP Apps iframe while the banner advertises the unusable port.
|
|
strictPort: true,
|
|
// Allow Vite to serve source files from the repo root (core/ lives
|
|
// outside clients/web), matching `vite.config.ts`'s `server.fs.allow`.
|
|
fs: {
|
|
allow: [repoRoot],
|
|
},
|
|
},
|
|
plugins: [react(), honoMiddlewarePlugin(config)],
|
|
};
|
|
const server = await createServer(inlineConfig);
|
|
|
|
await server.listen();
|
|
|
|
return {
|
|
async close(): Promise<void> {
|
|
await server.close();
|
|
},
|
|
};
|
|
}
|