ictrp-mcp-server 0.1.0

package/dist/runtime/sidecar-client.js.map

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

package/dist/runtime/supervisor.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Sidecar supervisor: start the Python process, wait for it to answer, stop it.
+ *
+ * The supervisor's whole job is to make "the sidecar is not running" a
+ * transient condition rather than an error the user has to understand. It
+ * starts lazily -- the first tool call that needs it triggers the spawn -- and
+ * it never starts more than one.
+ *
+ * Two details that are easy to get wrong and expensive to debug:
+ *
+ *   - The child's stdout must not be inherited. stdout is the MCP protocol
+ *     channel; a stray byte from Python corrupts the stream and the client
+ *     sees a protocol error rather than a print statement. The sidecar's output
+ *     is captured and forwarded to stderr.
+ *
+ *   - Readiness is a successful `/health` response, not "the process exists".
+ *     A Python process that started and immediately died on an ImportError
+ *     exists for long enough to fool a naive check.
+ */
+import { type SidecarResult, type HealthPayload } from "./sidecar-client.js";
+export declare function sidecarLogTail(): string[];
+export declare function isSidecarSpawned(): boolean;
+export declare function sidecarPid(): number | undefined;
+/**
+ * Spawn the sidecar and wait until it answers.
+ *
+ * Concurrent callers share one startup attempt: two tool calls racing on a cold
+ * start must not produce two Python processes fighting over the same port.
+ */
+export declare function ensureSidecar(opts?: {
+    autoStart?: boolean;
+}): Promise<SidecarResult<HealthPayload>>;
+/**
+ * Stop the sidecar.
+ *
+ * SIGTERM first so the sidecar can close its HTTP server and flush, then
+ * SIGKILL if it does not go. Called on process exit and on `ictrp-setup clean`.
+ */
+export declare function stopSidecar(timeoutMs?: number): Promise<void>;
+/**
+ * Arrange for the sidecar to be stopped when this process ends.
+ *
+ * Registered once at startup. Without it, an MCP client that closes the stdio
+ * stream leaves an orphaned Python process holding the port, and the next
+ * launch fails to bind.
+ */
+export declare function installShutdownHooks(): void;

package/dist/runtime/supervisor.js

@@ -0,0 +1,248 @@
+/**
+ * Sidecar supervisor: start the Python process, wait for it to answer, stop it.
+ *
+ * The supervisor's whole job is to make "the sidecar is not running" a
+ * transient condition rather than an error the user has to understand. It
+ * starts lazily -- the first tool call that needs it triggers the spawn -- and
+ * it never starts more than one.
+ *
+ * Two details that are easy to get wrong and expensive to debug:
+ *
+ *   - The child's stdout must not be inherited. stdout is the MCP protocol
+ *     channel; a stray byte from Python corrupts the stream and the client
+ *     sees a protocol error rather than a print statement. The sidecar's output
+ *     is captured and forwarded to stderr.
+ *
+ *   - Readiness is a successful `/health` response, not "the process exists".
+ *     A Python process that started and immediately died on an ImportError
+ *     exists for long enough to fool a naive check.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { pingSidecar } from "./sidecar-client.js";
+import { sidecarBaseUrl, sidecarScript, venvPython } from "./env-probe.js";
+/** How long to wait for a freshly spawned sidecar to answer /health. */
+const READY_TIMEOUT_MS = 20_000;
+const READY_POLL_MS = 250;
+let child;
+let starting;
+/** Recent sidecar stderr, kept so a failed start can explain itself. */
+const recentOutput = [];
+const MAX_RECENT_LINES = 40;
+function log(message) {
+    // stderr only. stdout belongs to the MCP transport.
+    process.stderr.write(`[ictrp-sidecar] ${message}\n`);
+}
+function remember(line) {
+    recentOutput.push(line);
+    if (recentOutput.length > MAX_RECENT_LINES)
+        recentOutput.shift();
+}
+export function sidecarLogTail() {
+    return [...recentOutput];
+}
+export function isSidecarSpawned() {
+    return !!child && !child.killed && child.exitCode === null;
+}
+export function sidecarPid() {
+    return child?.pid;
+}
+function parsePort() {
+    const raw = process.env.ICTRP_SIDECAR_PORT;
+    const parsed = raw ? Number(raw) : NaN;
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 8849;
+}
+function host() {
+    return process.env.ICTRP_SIDECAR_HOST?.trim() || "127.0.0.1";
+}
+/**
+ * Spawn the sidecar and wait until it answers.
+ *
+ * Concurrent callers share one startup attempt: two tool calls racing on a cold
+ * start must not produce two Python processes fighting over the same port.
+ */
+export async function ensureSidecar(opts = {}) {
+    const autoStart = opts.autoStart ?? process.env.ICTRP_AUTOSTART_SIDECAR !== "0";
+    const alive = await pingSidecar();
+    if (alive.ok)
+        return alive;
+    if (!autoStart) {
+        return {
+            ok: false,
+            code: "SIDECAR_NOT_RUNNING",
+            message: `sidecar is not running at ${sidecarBaseUrl()} and autostart is disabled`,
+            retryable: true,
+            hint: "Start it with `npx ictrp-setup sidecar`.",
+        };
+    }
+    if (starting)
+        return starting;
+    const promise = startAndWait();
+    starting = promise;
+    try {
+        return await promise;
+    }
+    finally {
+        if (starting === promise)
+            starting = undefined;
+    }
+}
+async function startAndWait() {
+    const python = venvPython();
+    const script = sidecarScript();
+    if (!existsSync(python)) {
+        return {
+            ok: false,
+            code: "SIDECAR_NO_VENV",
+            message: `no interpreter at ${python}`,
+            retryable: false,
+            hint: "Run `npx ictrp-setup setup` to create the private Python environment.",
+        };
+    }
+    if (!existsSync(script)) {
+        return {
+            ok: false,
+            code: "SIDECAR_NO_SCRIPT",
+            message: `no sidecar script at ${script}`,
+            retryable: false,
+            hint: "The package is incomplete; reinstall it.",
+        };
+    }
+    const port = parsePort();
+    const args = [script, "--host", host(), "--port", String(port)];
+    log(`starting: ${python} ${args.join(" ")}`);
+    recentOutput.length = 0;
+    child = spawn(python, args, {
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        env: {
+            ...process.env,
+            PYTHONUNBUFFERED: "1",
+            ICTRP_SIDECAR_HOST: host(),
+            ICTRP_SIDECAR_PORT: String(port),
+        },
+    });
+    child.stdout?.on("data", (buf) => {
+        for (const line of buf.toString("utf8").split(/[\r\n]+/)) {
+            if (line.trim())
+                remember(line.trim());
+        }
+    });
+    child.stderr?.on("data", (buf) => {
+        for (const line of buf.toString("utf8").split(/[\r\n]+/)) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            remember(trimmed);
+            log(trimmed);
+        }
+    });
+    let spawnError;
+    child.on("error", (err) => {
+        spawnError = err.message;
+        log(`spawn error: ${err.message}`);
+    });
+    let exited;
+    child.on("exit", (code, signal) => {
+        exited = { code, signal };
+        log(`exited (code=${code ?? "null"} signal=${signal ?? "null"})`);
+        child = undefined;
+    });
+    const deadline = Date.now() + READY_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        await sleep(READY_POLL_MS);
+        if (spawnError) {
+            return {
+                ok: false,
+                code: "SIDECAR_SPAWN_FAILED",
+                message: `could not spawn the sidecar: ${spawnError}`,
+                retryable: false,
+                hint: "Check that the venv interpreter is executable.",
+            };
+        }
+        if (exited) {
+            // The process died. Its last words are the most useful thing we have.
+            const tail = sidecarLogTail().slice(-8).join("\n");
+            return {
+                ok: false,
+                code: "SIDECAR_DIED",
+                message: `sidecar exited immediately (code=${exited.code ?? "null"})${tail ? `:\n${tail}` : ""}`,
+                retryable: false,
+                hint: "Run `npx ictrp-setup doctor` for a full environment report.",
+            };
+        }
+        const health = await pingSidecar();
+        if (health.ok) {
+            log(`ready (pid ${child?.pid ?? "?"})`);
+            return health;
+        }
+    }
+    return {
+        ok: false,
+        code: "SIDECAR_START_TIMEOUT",
+        message: `sidecar did not answer /health within ${READY_TIMEOUT_MS}ms`,
+        retryable: true,
+        hint: `Check that port ${port} is free, or set ICTRP_SIDECAR_PORT.`,
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Stop the sidecar.
+ *
+ * SIGTERM first so the sidecar can close its HTTP server and flush, then
+ * SIGKILL if it does not go. Called on process exit and on `ictrp-setup clean`.
+ */
+export async function stopSidecar(timeoutMs = 5_000) {
+    const proc = child;
+    if (!proc || proc.exitCode !== null) {
+        child = undefined;
+        return;
+    }
+    await new Promise((resolve) => {
+        const done = () => {
+            clearTimeout(killTimer);
+            resolve();
+        };
+        const killTimer = setTimeout(() => {
+            log("did not exit on SIGTERM; killing");
+            try {
+                proc.kill("SIGKILL");
+            }
+            catch {
+                /* already gone */
+            }
+            resolve();
+        }, timeoutMs);
+        proc.once("exit", done);
+        try {
+            proc.kill("SIGTERM");
+        }
+        catch {
+            clearTimeout(killTimer);
+            resolve();
+        }
+    });
+    child = undefined;
+}
+/**
+ * Arrange for the sidecar to be stopped when this process ends.
+ *
+ * Registered once at startup. Without it, an MCP client that closes the stdio
+ * stream leaves an orphaned Python process holding the port, and the next
+ * launch fails to bind.
+ */
+export function installShutdownHooks() {
+    const shutdown = () => {
+        void stopSidecar(2_000);
+    };
+    process.once("exit", shutdown);
+    process.once("SIGINT", () => {
+        void stopSidecar(2_000).then(() => process.exit(130));
+    });
+    process.once("SIGTERM", () => {
+        void stopSidecar(2_000).then(() => process.exit(143));
+    });
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/runtime/supervisor.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "ictrp-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for the WHO International Clinical Trials Registry Platform (ICTRP). Plain HTTP, no browser. Every response is explicit about the export's known incompleteness.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ictrp-mcp-server": "./dist/index.js",
+    "ictrp-setup": "./dist/cli/setup-cli.js"
+  },
+  "files": [
+    "dist",
+    "sidecar",
+    "README.md",
+    "README_ZH.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepack": "node scripts/prune-tests.mjs",
+    "cli": "node dist/index.js",
+    "doctor": "node dist/cli/setup-cli.js doctor",
+    "setup": "node dist/cli/setup-cli.js setup",
+    "sidecar": "node dist/cli/setup-cli.js sidecar",
+    "postinstall": "node dist/cli/setup-cli.js postinstall",
+    "vendor": "node scripts/vendor-sidecar.mjs",
+    "prepublishOnly": "npm run build && npm run vendor && node scripts/prune-tests.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "clinical-trials",
+    "ictrp",
+    "who",
+    "trial-registry",
+    "chictr"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/opencare-skillhub/ictrp-mcp-service.git"
+  },
+  "homepage": "https://github.com/opencare-skillhub/ictrp-mcp-service#readme",
+  "bugs": {
+    "url": "https://github.com/opencare-skillhub/ictrp-mcp-service/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.9.3"
+  }
+}