@procedures/mcp-dev-tools 0.13.2 → 0.14.1

package/dist/host.d.ts

@@ -7,9 +7,10 @@
  * - `strictCalls`: a procedure of code that declares no nested calls calls only tools;
  * - each tool call has a time limit.
  *
- * `server.ts` (the file in the MCP configuration of Claude Code) and `mark mcp` both start the
- * server with `startDevToolsServer()`. The host comes from `createMcpHost()` of
- * `@procedures/mcp-server` (CLI-10): the same factory as `mcp.serve` and the hosts of the apps.
+ * `server.ts` (the file in the MCP configuration of Claude Code) and `mark mcp` both run the
+ * server with `runDevToolsServer()`, under `run()` of `@mark1russell7/service` (CLI-11). The host
+ * comes from `createMcpHost()` of `@procedures/mcp-server` (CLI-10): the same factory as
+ * `mcp.serve` and the hosts of the apps.
  *
  * `MCP_FS_ROOT` confines the procedures to one folder (`confineToRoot()` of `@procedures/fs`):
  * each tool keeps its paths in it, or the root refuses the tool. The host serves no remote
@@ -17,6 +18,7 @@
  */
 import { ProcedureServer, type HostPolicy, type ProcedureModule, type ProcedureRegistry, type ToolSurface } from "@procedures/client";
 import { type BundleSurfaceModule, type McpHost } from "@procedures/mcp-server";
+import { type Lifecycle, type RunOptions, type ServiceBuilder } from "@mark1russell7/service";
 import { type McpServerConfig } from "./config.js";
 /** The modules and the tool lists of some bundles. */
 export interface LoadedBundles {
@@ -43,13 +45,45 @@ export interface DevToolsHost {
     /** The MCP host: `mcp.start()` starts its face (stdio, or Streamable HTTP with `config.http`). */
     mcp: McpHost;
 }
+/** The options of `createDevToolsHost()`. */
+export interface DevToolsHostOptions {
+    /**
+     * True: the HTTP face has no listener of its own, and the caller mounts `mcp.handleHttp` on a
+     * listener. `runDevToolsServer()` gives true. The default is false, the listener of the face.
+     */
+    mountHttp?: boolean | undefined;
+}
 /** This function builds the host. It starts no transport. */
-export declare function createDevToolsHost(config?: McpServerConfig): Promise<DevToolsHost>;
+export declare function createDevToolsHost(config?: McpServerConfig, options?: DevToolsHostOptions): Promise<DevToolsHost>;
+/** A dev-tools server that runs under `run()`: the host, its service, the lifecycle and the URL of HTTP. */
+export interface RunningDevToolsServer {
+    readonly host: DevToolsHost;
+    readonly service: ServiceBuilder;
+    /** The lifecycle: `life.done` resolves with the exit code after the stop. */
+    readonly life: Lifecycle;
+    /** The URL of the Streamable HTTP endpoint, with `config.http`. */
+    readonly url?: string | undefined;
+}
+/**
+ * This function runs the dev-tools MCP server under `run()` of `@mark1russell7/service` (CLI-11).
+ * The runner owns the signals, the stop in stages and the exit of the process.
+ *
+ * - Over stdio, the profile is `ephemeral`, and the end of the input is the trigger `stdin-close`.
+ *   stdout carries the protocol, so `console.log` goes to stderr from here on (BUGS-2026-07 Bug5).
+ * - With `config.http`, the profile is `localDev`. An `httpTransport` of the service listens on the
+ *   port, and the Streamable HTTP face mounts on it at `/mcp`. The address is loopback by default.
+ *
+ * After a startup that failed, `life.errors` tells why, and the process exits with the code 1.
+ */
+export declare function runDevToolsServer(config?: McpServerConfig, run?: RunOptions): Promise<RunningDevToolsServer>;
 /**
  * This function starts the dev-tools MCP server over stdio, or over Streamable HTTP with
  * `config.http` (roadmap R26). Over stdio, stdout carries the protocol, so `console.log` goes to
  * stderr from here on (BUGS-2026-07 Bug5). The stdio server stops when the client closes its
  * input: `host.mcp.closed` then resolves.
+ *
+ * @deprecated Use `runDevToolsServer()`: it runs the server under `run()` of the service, with a
+ * listener of the service for HTTP. The next MINOR removes this function (CLI-11).
  */
 export declare function startDevToolsServer(config?: McpServerConfig): Promise<DevToolsHost>;
 //# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,eAAe,EAGf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,OAAO,EAEb,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ/D,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAgBpF;AAaD,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,kGAAkG;IAClG,GAAG,EAAE,OAAO,CAAC;CACd;AAcD,6DAA6D;AAC7D,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,eAA8B,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCtG;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAE,eAA8B,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBvG"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,eAAe,EAGf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,OAAO,EAEb,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAgC,KAAK,SAAS,EAAgB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE1I,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ/D,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAgBpF;AAaD,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,kGAAkG;IAClG,GAAG,EAAE,OAAO,CAAC;CACd;AAkBD,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAED,6DAA6D;AAC7D,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,eAA8B,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCzI;AASD,4GAA4G;AAC5G,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,eAA8B,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAiChI;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAE,eAA8B,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBvG"}

package/dist/host.js

@@ -7,9 +7,10 @@
  * - `strictCalls`: a procedure of code that declares no nested calls calls only tools;
  * - each tool call has a time limit.
  *
- * `server.ts` (the file in the MCP configuration of Claude Code) and `mark mcp` both start the
- * server with `startDevToolsServer()`. The host comes from `createMcpHost()` of
- * `@procedures/mcp-server` (CLI-10): the same factory as `mcp.serve` and the hosts of the apps.
+ * `server.ts` (the file in the MCP configuration of Claude Code) and `mark mcp` both run the
+ * server with `runDevToolsServer()`, under `run()` of `@mark1russell7/service` (CLI-11). The host
+ * comes from `createMcpHost()` of `@procedures/mcp-server` (CLI-10): the same factory as
+ * `mcp.serve` and the hosts of the apps.
  *
  * `MCP_FS_ROOT` confines the procedures to one folder (`confineToRoot()` of `@procedures/fs`):
  * each tool keeps its paths in it, or the root refuses the tool. The host serves no remote
@@ -18,8 +19,11 @@
 import { PROCEDURE_REGISTRY, ProcedureServer, createRegistry, registerClientProcedures, } from "@procedures/client";
 import { createMcpHost, mergeSurfaces, redirectConsoleToStderr, } from "@procedures/mcp-server";
 import { programCheckInterceptor } from "@procedures/compiler";
+import { createServer } from "node:http";
+import { ephemeral, localDev, service } from "@mark1russell7/service";
+import { httpTransport } from "@mark1russell7/service/http";
 import { loadConfig } from "./config.js";
-import { ms } from "@procedures/client";
+import { ms, seconds } from "@procedures/client";
 /** This function loads the module entry of each bundle (it registers nothing). */
 export async function loadBundles(bundles) {
     const modules = [];
@@ -50,10 +54,15 @@ async function loadBundlesGlobally(bundles) {
     }
     return { modules: [], surfaces, global: true };
 }
-/** The face of the configuration: Streamable HTTP with `config.http`, else stdio. */
-function facesOf(config) {
+/**
+ * The face of the configuration: Streamable HTTP with `config.http`, else stdio. With `mount`, the
+ * HTTP face has no listener of its own: the listener of the service answers for it (CLI-11).
+ */
+function facesOf(config, mount) {
     if (!config.http)
         return { stdio: true };
+    if (mount)
+        return { http: { mount: true, ...(config.http.token ? { token: config.http.token } : {}) } };
     return {
         http: {
             port: config.http.port,
@@ -63,7 +72,7 @@ function facesOf(config) {
     };
 }
 /** This function builds the host. It starts no transport. */
-export async function createDevToolsHost(config = loadConfig()) {
+export async function createDevToolsHost(config = loadConfig(), options = {}) {
     const loaded = await loadBundles(config.bundles);
     const registry = loaded.global ? PROCEDURE_REGISTRY : createRegistry(...loaded.modules);
     // MCP_FS_ROOT (roadmap R33): each procedure of the registry keeps its paths in the root, also
@@ -88,7 +97,7 @@ export async function createDevToolsHost(config = loadConfig()) {
         name: config.serverName,
         version: config.serverVersion,
         debug: config.debug,
-        faces: facesOf(config),
+        faces: facesOf(config, options.mountHttp === true),
     });
     return {
         registry,
@@ -99,11 +108,68 @@ export async function createDevToolsHost(config = loadConfig()) {
         ...(fsRoot !== undefined ? { fsRoot, refusedUnderRoot } : {}),
     };
 }
+/** The knobs of the HTTP listener on the computer of a developer, as data (as the procedures host gives them). */
+const LISTENER_KNOBS = Object.freeze({
+    server_idle_close: seconds(5),
+    server_idle_sweep_interval: seconds(1),
+    server_retry_after: seconds(1),
+});
+/**
+ * This function runs the dev-tools MCP server under `run()` of `@mark1russell7/service` (CLI-11).
+ * The runner owns the signals, the stop in stages and the exit of the process.
+ *
+ * - Over stdio, the profile is `ephemeral`, and the end of the input is the trigger `stdin-close`.
+ *   stdout carries the protocol, so `console.log` goes to stderr from here on (BUGS-2026-07 Bug5).
+ * - With `config.http`, the profile is `localDev`. An `httpTransport` of the service listens on the
+ *   port, and the Streamable HTTP face mounts on it at `/mcp`. The address is loopback by default.
+ *
+ * After a startup that failed, `life.errors` tells why, and the process exits with the code 1.
+ */
+export async function runDevToolsServer(config = loadConfig(), run) {
+    // Defense-in-depth for the stdio transport: a stray console.log would corrupt the protocol
+    redirectConsoleToStderr();
+    if (config.debug)
+        console.error("[mcp-server] Starting with config:", JSON.stringify(config, null, 2));
+    const host = await createDevToolsHost(config, { mountHttp: true });
+    const profile = config.http ? localDev : ephemeral;
+    const svc = host.mcp.declare(service("mcp-dev-tools").profile(profile));
+    // A profile without policies leaves them to the service (as runProcedureHost does)
+    if (!profile.readiness)
+        svc.readiness({ type: "debounce", interval: seconds(5), failAfter: 3, recoverAfter: 1 });
+    if (!profile.liveness)
+        svc.liveness({ type: "window", failAfter: seconds(45) });
+    if (!profile.startup)
+        svc.startup(seconds(30));
+    let listener;
+    if (config.http) {
+        const address = config.http.host ?? "127.0.0.1";
+        listener = httpTransport(createServer(), LISTENER_KNOBS, { listen: { port: config.http.port, host: address } });
+        listener.mount((req, res) => host.mcp.handleHttp(req, res));
+        svc.server("mcp-dev-tools.listen", listener.knobs, listener);
+    }
+    const life = await svc.run(run);
+    const face = host.mcp.state().faces[0];
+    if (config.debug)
+        console.error(`[mcp-server] Started with ${face?.toolCount ?? 0} tools`);
+    if (host.fsRoot !== undefined)
+        console.error(`[mcp-server] Each tool refuses a path outside ${host.fsRoot}. Refused under the root: ${String(host.refusedUnderRoot)}`);
+    let url;
+    const bound = listener?.server.address();
+    if (config.http && bound && typeof bound === "object") {
+        const shown = bound.address === "0.0.0.0" || bound.address === "::" ? "localhost" : bound.address.includes(":") ? `[${bound.address}]` : bound.address;
+        url = `http://${shown}:${bound.port}/mcp`;
+        console.error(`[mcp-server] Streamable HTTP at ${url}${config.http.token ? " (send Authorization: Bearer <token>)" : ""}`);
+    }
+    return { host, service: svc, life, ...(url ? { url } : {}) };
+}
 /**
  * This function starts the dev-tools MCP server over stdio, or over Streamable HTTP with
  * `config.http` (roadmap R26). Over stdio, stdout carries the protocol, so `console.log` goes to
  * stderr from here on (BUGS-2026-07 Bug5). The stdio server stops when the client closes its
  * input: `host.mcp.closed` then resolves.
+ *
+ * @deprecated Use `runDevToolsServer()`: it runs the server under `run()` of the service, with a
+ * listener of the service for HTTP. The next MINOR removes this function (CLI-11).
  */
 export async function startDevToolsServer(config = loadConfig()) {
     // Defense-in-depth for the stdio transport: a stray console.log (from a procedure handler, a

package/dist/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,9 +2,10 @@
  * @procedures/mcp-dev-tools (folder packages/impl-mcp-dev)
  *
  * Ready-to-use MCP server exposing the procedure ecosystem to Claude. Importing this entry
- * starts nothing: `startDevToolsServer()` starts the server (as `dist/server.js` and `mark mcp`
- * do), and `createDevToolsHost()` builds the host without a transport.
+ * starts nothing: `runDevToolsServer()` runs the server under `run()` of the service (as
+ * `dist/server.js` and `mark mcp` do), and `createDevToolsHost()` builds the host without a
+ * transport. `startDevToolsServer()` is deprecated (CLI-11).
  */
 export { loadConfig, type McpServerConfig } from "./config.js";
-export { createDevToolsHost, startDevToolsServer, loadBundles, type DevToolsHost, type LoadedBundles, } from "./host.js";
+export { createDevToolsHost, runDevToolsServer, startDevToolsServer, loadBundles, type DevToolsHost, type DevToolsHostOptions, type LoadedBundles, type RunningDevToolsServer, } from "./host.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -2,9 +2,10 @@
  * @procedures/mcp-dev-tools (folder packages/impl-mcp-dev)
  *
  * Ready-to-use MCP server exposing the procedure ecosystem to Claude. Importing this entry
- * starts nothing: `startDevToolsServer()` starts the server (as `dist/server.js` and `mark mcp`
- * do), and `createDevToolsHost()` builds the host without a transport.
+ * starts nothing: `runDevToolsServer()` runs the server under `run()` of the service (as
+ * `dist/server.js` and `mark mcp` do), and `createDevToolsHost()` builds the host without a
+ * transport. `startDevToolsServer()` is deprecated (CLI-11).
  */
 export { loadConfig } from "./config.js";
-export { createDevToolsHost, startDevToolsServer, loadBundles, } from "./host.js";
+export { createDevToolsHost, runDevToolsServer, startDevToolsServer, loadBundles, } from "./host.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAwB,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,GAGZ,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAwB,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GAKZ,MAAM,WAAW,CAAC"}

package/dist/server.d.ts

@@ -5,8 +5,9 @@
  * MCP configuration of a client runs this file (`node packages/impl-mcp-dev/dist/server.js`).
  * Configurable via environment variables (see `config.ts`). `mark mcp` starts the same server.
  *
- * When the client closes the input of stdio, the host stops (the calls in flight get their grace
- * time), and this process ends (CLI-10).
+ * The server runs under `run()` of `@mark1russell7/service` (CLI-11). The runner owns the signals,
+ * the stop in stages and the exit. When the client closes the input of stdio, the trigger
+ * `stdin-close` stops the host (the calls in flight get the drain time), and the process exits.
  */
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/server.js

@@ -5,16 +5,12 @@
  * MCP configuration of a client runs this file (`node packages/impl-mcp-dev/dist/server.js`).
  * Configurable via environment variables (see `config.ts`). `mark mcp` starts the same server.
  *
- * When the client closes the input of stdio, the host stops (the calls in flight get their grace
- * time), and this process ends (CLI-10).
+ * The server runs under `run()` of `@mark1russell7/service` (CLI-11). The runner owns the signals,
+ * the stop in stages and the exit. When the client closes the input of stdio, the trigger
+ * `stdin-close` stops the host (the calls in flight get the drain time), and the process exits.
  */
-import { startDevToolsServer } from "./host.js";
-startDevToolsServer()
-    .then(async (host) => {
-    await host.mcp.closed;
-    process.exit(0);
-})
-    .catch((error) => {
+import { runDevToolsServer } from "./host.js";
+runDevToolsServer().catch((error) => {
     console.error("[mcp-server] Fatal error:", error);
     process.exit(1);
 });

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,mBAAmB,EAAE;KAClB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACnB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAClC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/mcp-dev-tools",
-  "version": "0.13.2",
+  "version": "0.14.1",
   "description": "A ready-to-use MCP server for Claude Code and Claude Desktop: 91 developer tools (docker, mongo, sqlite, cue, vitest, workspace) with a strict call policy.",
   "keywords": [
     "mcp",
@@ -53,11 +53,12 @@
     "provenance": true
   },
   "dependencies": {
-    "@procedures/bundle-mcp": "0.13.2",
-    "@procedures/client": "0.13.2",
-    "@procedures/compiler": "0.13.2",
-    "@procedures/fs": "0.13.2",
-    "@procedures/mcp-server": "0.13.2"
+    "@mark1russell7/service": "^0.5.2",
+    "@procedures/bundle-mcp": "0.14.1",
+    "@procedures/client": "0.14.1",
+    "@procedures/compiler": "0.14.1",
+    "@procedures/fs": "0.14.1",
+    "@procedures/mcp-server": "0.14.1"
   },
   "devDependencies": {
     "@mark1russell7/cue": "^1.0.0",

package/src/host.ts

@@ -7,9 +7,10 @@
  * - `strictCalls`: a procedure of code that declares no nested calls calls only tools;
  * - each tool call has a time limit.
  *
- * `server.ts` (the file in the MCP configuration of Claude Code) and `mark mcp` both start the
- * server with `startDevToolsServer()`. The host comes from `createMcpHost()` of
- * `@procedures/mcp-server` (CLI-10): the same factory as `mcp.serve` and the hosts of the apps.
+ * `server.ts` (the file in the MCP configuration of Claude Code) and `mark mcp` both run the
+ * server with `runDevToolsServer()`, under `run()` of `@mark1russell7/service` (CLI-11). The host
+ * comes from `createMcpHost()` of `@procedures/mcp-server` (CLI-10): the same factory as
+ * `mcp.serve` and the hosts of the apps.
  *
  * `MCP_FS_ROOT` confines the procedures to one folder (`confineToRoot()` of `@procedures/fs`):
  * each tool keeps its paths in it, or the root refuses the tool. The host serves no remote
@@ -35,8 +36,11 @@ import {
   type McpHostFaces,
 } from "@procedures/mcp-server";
 import { programCheckInterceptor } from "@procedures/compiler";
+import { createServer } from "node:http";
+import { ephemeral, localDev, service, type Lifecycle, type Profile, type RunOptions, type ServiceBuilder } from "@mark1russell7/service";
+import { httpTransport, type HttpKnobs, type HttpTransport } from "@mark1russell7/service/http";
 import { loadConfig, type McpServerConfig } from "./config.js";
-import { ms } from "@procedures/client";
+import { ms, seconds } from "@procedures/client";
 
 /** The exports of a bundle's `module` entry: its module and the lists of its tools. */
 interface BundleModuleExports extends BundleSurfaceModule {
@@ -98,9 +102,13 @@ export interface DevToolsHost {
   mcp: McpHost;
 }
 
-/** The face of the configuration: Streamable HTTP with `config.http`, else stdio. */
-function facesOf(config: McpServerConfig): McpHostFaces {
+/**
+ * The face of the configuration: Streamable HTTP with `config.http`, else stdio. With `mount`, the
+ * HTTP face has no listener of its own: the listener of the service answers for it (CLI-11).
+ */
+function facesOf(config: McpServerConfig, mount: boolean): McpHostFaces {
   if (!config.http) return { stdio: true };
+  if (mount) return { http: { mount: true, ...(config.http.token ? { token: config.http.token } : {}) } };
   return {
     http: {
       port: config.http.port,
@@ -110,8 +118,17 @@ function facesOf(config: McpServerConfig): McpHostFaces {
   };
 }
 
+/** The options of `createDevToolsHost()`. */
+export interface DevToolsHostOptions {
+  /**
+   * True: the HTTP face has no listener of its own, and the caller mounts `mcp.handleHttp` on a
+   * listener. `runDevToolsServer()` gives true. The default is false, the listener of the face.
+   */
+  mountHttp?: boolean | undefined;
+}
+
 /** This function builds the host. It starts no transport. */
-export async function createDevToolsHost(config: McpServerConfig = loadConfig()): Promise<DevToolsHost> {
+export async function createDevToolsHost(config: McpServerConfig = loadConfig(), options: DevToolsHostOptions = {}): Promise<DevToolsHost> {
   const loaded = await loadBundles(config.bundles);
   const registry = loaded.global ? PROCEDURE_REGISTRY : createRegistry(...loaded.modules);
   // MCP_FS_ROOT (roadmap R33): each procedure of the registry keeps its paths in the root, also
@@ -136,7 +153,7 @@ export async function createDevToolsHost(config: McpServerConfig = loadConfig())
     name: config.serverName,
     version: config.serverVersion,
     debug: config.debug,
-    faces: facesOf(config),
+    faces: facesOf(config, options.mountHttp === true),
   });
   return {
     registry,
@@ -148,11 +165,77 @@ export async function createDevToolsHost(config: McpServerConfig = loadConfig())
   };
 }
 
+/** The knobs of the HTTP listener on the computer of a developer, as data (as the procedures host gives them). */
+const LISTENER_KNOBS: HttpKnobs = Object.freeze({
+  server_idle_close: seconds(5),
+  server_idle_sweep_interval: seconds(1),
+  server_retry_after: seconds(1),
+});
+
+/** A dev-tools server that runs under `run()`: the host, its service, the lifecycle and the URL of HTTP. */
+export interface RunningDevToolsServer {
+  readonly host: DevToolsHost;
+  readonly service: ServiceBuilder;
+  /** The lifecycle: `life.done` resolves with the exit code after the stop. */
+  readonly life: Lifecycle;
+  /** The URL of the Streamable HTTP endpoint, with `config.http`. */
+  readonly url?: string | undefined;
+}
+
+/**
+ * This function runs the dev-tools MCP server under `run()` of `@mark1russell7/service` (CLI-11).
+ * The runner owns the signals, the stop in stages and the exit of the process.
+ *
+ * - Over stdio, the profile is `ephemeral`, and the end of the input is the trigger `stdin-close`.
+ *   stdout carries the protocol, so `console.log` goes to stderr from here on (BUGS-2026-07 Bug5).
+ * - With `config.http`, the profile is `localDev`. An `httpTransport` of the service listens on the
+ *   port, and the Streamable HTTP face mounts on it at `/mcp`. The address is loopback by default.
+ *
+ * After a startup that failed, `life.errors` tells why, and the process exits with the code 1.
+ */
+export async function runDevToolsServer(config: McpServerConfig = loadConfig(), run?: RunOptions): Promise<RunningDevToolsServer> {
+  // Defense-in-depth for the stdio transport: a stray console.log would corrupt the protocol
+  redirectConsoleToStderr();
+  if (config.debug) console.error("[mcp-server] Starting with config:", JSON.stringify(config, null, 2));
+
+  const host = await createDevToolsHost(config, { mountHttp: true });
+  const profile: Profile = config.http ? localDev : ephemeral;
+  const svc = host.mcp.declare(service("mcp-dev-tools").profile(profile));
+  // A profile without policies leaves them to the service (as runProcedureHost does)
+  if (!profile.readiness) svc.readiness({ type: "debounce", interval: seconds(5), failAfter: 3, recoverAfter: 1 });
+  if (!profile.liveness) svc.liveness({ type: "window", failAfter: seconds(45) });
+  if (!profile.startup) svc.startup(seconds(30));
+
+  let listener: HttpTransport | undefined;
+  if (config.http) {
+    const address = config.http.host ?? "127.0.0.1";
+    listener = httpTransport(createServer(), LISTENER_KNOBS, { listen: { port: config.http.port, host: address } });
+    listener.mount((req, res) => host.mcp.handleHttp(req, res));
+    svc.server("mcp-dev-tools.listen", listener.knobs, listener);
+  }
+
+  const life = await svc.run(run);
+  const face = host.mcp.state().faces[0];
+  if (config.debug) console.error(`[mcp-server] Started with ${face?.toolCount ?? 0} tools`);
+  if (host.fsRoot !== undefined) console.error(`[mcp-server] Each tool refuses a path outside ${host.fsRoot}. Refused under the root: ${String(host.refusedUnderRoot)}`);
+  let url: string | undefined;
+  const bound = listener?.server.address();
+  if (config.http && bound && typeof bound === "object") {
+    const shown = bound.address === "0.0.0.0" || bound.address === "::" ? "localhost" : bound.address.includes(":") ? `[${bound.address}]` : bound.address;
+    url = `http://${shown}:${bound.port}/mcp`;
+    console.error(`[mcp-server] Streamable HTTP at ${url}${config.http.token ? " (send Authorization: Bearer <token>)" : ""}`);
+  }
+  return { host, service: svc, life, ...(url ? { url } : {}) };
+}
+
 /**
  * This function starts the dev-tools MCP server over stdio, or over Streamable HTTP with
  * `config.http` (roadmap R26). Over stdio, stdout carries the protocol, so `console.log` goes to
  * stderr from here on (BUGS-2026-07 Bug5). The stdio server stops when the client closes its
  * input: `host.mcp.closed` then resolves.
+ *
+ * @deprecated Use `runDevToolsServer()`: it runs the server under `run()` of the service, with a
+ * listener of the service for HTTP. The next MINOR removes this function (CLI-11).
  */
 export async function startDevToolsServer(config: McpServerConfig = loadConfig()): Promise<DevToolsHost> {
   // Defense-in-depth for the stdio transport: a stray console.log (from a procedure handler, a

package/src/index.ts

@@ -2,15 +2,19 @@
  * @procedures/mcp-dev-tools (folder packages/impl-mcp-dev)
  *
  * Ready-to-use MCP server exposing the procedure ecosystem to Claude. Importing this entry
- * starts nothing: `startDevToolsServer()` starts the server (as `dist/server.js` and `mark mcp`
- * do), and `createDevToolsHost()` builds the host without a transport.
+ * starts nothing: `runDevToolsServer()` runs the server under `run()` of the service (as
+ * `dist/server.js` and `mark mcp` do), and `createDevToolsHost()` builds the host without a
+ * transport. `startDevToolsServer()` is deprecated (CLI-11).
  */
 
 export { loadConfig, type McpServerConfig } from "./config.js";
 export {
   createDevToolsHost,
+  runDevToolsServer,
   startDevToolsServer,
   loadBundles,
   type DevToolsHost,
+  type DevToolsHostOptions,
   type LoadedBundles,
+  type RunningDevToolsServer,
 } from "./host.js";

package/src/server.ts

@@ -5,18 +5,14 @@
  * MCP configuration of a client runs this file (`node packages/impl-mcp-dev/dist/server.js`).
  * Configurable via environment variables (see `config.ts`). `mark mcp` starts the same server.
  *
- * When the client closes the input of stdio, the host stops (the calls in flight get their grace
- * time), and this process ends (CLI-10).
+ * The server runs under `run()` of `@mark1russell7/service` (CLI-11). The runner owns the signals,
+ * the stop in stages and the exit. When the client closes the input of stdio, the trigger
+ * `stdin-close` stops the host (the calls in flight get the drain time), and the process exits.
  */
 
-import { startDevToolsServer } from "./host.js";
+import { runDevToolsServer } from "./host.js";
 
-startDevToolsServer()
-  .then(async (host) => {
-    await host.mcp.closed;
-    process.exit(0);
-  })
-  .catch((error) => {
-    console.error("[mcp-server] Fatal error:", error);
-    process.exit(1);
-  });
+runDevToolsServer().catch((error) => {
+  console.error("[mcp-server] Fatal error:", error);
+  process.exit(1);
+});