@velocms/mcp 0.1.1 → 0.1.2

package/dist/env.d.ts

@@ -1,8 +1,10 @@
 /**
  * Pure env-resolution helper — kept separate from `index.ts` (which has a
  * `#!/usr/bin/env node` shebang and starts the stdio server as a side effect
- * on import) so the fail-fast "missing env var" behavior is unit-testable
- * without spawning a subprocess or calling `process.exit`.
+ * on import) so the missing-env-var handling is unit-testable without
+ * spawning a subprocess. Since 0.1.2 a missing variable no longer exits the
+ * process at startup — the server boots for introspection and the error is
+ * returned per tool call instead.
  */
 export interface VeloCmsEnvConfig {
     siteUrl: string;
@@ -20,5 +22,5 @@ export type VeloCmsEnvResolution = {
  * (defaults to `process.env`). Never logs the resolved values.
  */
 export declare function resolveEnvConfig(env?: NodeJS.ProcessEnv): VeloCmsEnvResolution;
-/** Human-readable message for the missing-env-var fail-fast path (stderr only, never stdout). */
+/** Human-readable message for the missing-env-var path (stderr warning at boot + per-tool-call error text; never stdout). */
 export declare function formatMissingEnvMessage(missing: string[]): string;

package/dist/env.js

@@ -1,8 +1,10 @@
 /**
  * Pure env-resolution helper — kept separate from `index.ts` (which has a
  * `#!/usr/bin/env node` shebang and starts the stdio server as a side effect
- * on import) so the fail-fast "missing env var" behavior is unit-testable
- * without spawning a subprocess or calling `process.exit`.
+ * on import) so the missing-env-var handling is unit-testable without
+ * spawning a subprocess. Since 0.1.2 a missing variable no longer exits the
+ * process at startup — the server boots for introspection and the error is
+ * returned per tool call instead.
  */
 /**
  * Reads `VELOCMS_SITE_URL` + `VELOCMS_API_KEY` from the given environment
@@ -21,7 +23,7 @@ export function resolveEnvConfig(env = process.env) {
     }
     return { ok: true, config: { siteUrl, apiKey } };
 }
-/** Human-readable message for the missing-env-var fail-fast path (stderr only, never stdout). */
+/** Human-readable message for the missing-env-var path (stderr warning at boot + per-tool-call error text; never stdout). */
 export function formatMissingEnvMessage(missing) {
     return (`[velocms-mcp] Missing required environment variable(s): ${missing.join(", ")}.\n` +
         "  VELOCMS_SITE_URL — your blog's base URL, e.g. https://myblog.velocms.org (or a bound custom domain)\n" +

package/dist/index.js

@@ -27,12 +27,30 @@ function formatError(err) {
     return `Error: ${String(err)}`;
 }
 async function main() {
+    // Env resolution is LAZY (first tool call), not a startup gate: MCP
+    // registries (e.g. Glama) boot the server without credentials and only
+    // need it to start + answer introspection (initialize / tools/list).
+    // A missing key therefore surfaces as a helpful per-call tool error
+    // inside the MCP client instead of a dead server. Warn once on stderr
+    // so interactive users still see the misconfiguration immediately.
     const resolution = resolveEnvConfig();
-    if (!resolution.ok) {
+    let client = null;
+    if (resolution.ok) {
+        client = new VeloCmsClient(resolution.config);
+    }
+    else {
         console.error(formatMissingEnvMessage(resolution.missing));
-        process.exit(1);
     }
-    const client = new VeloCmsClient(resolution.config);
+    /** Returns the API client, or the missing-env error message if unconfigured. */
+    function requireClient() {
+        if (client)
+            return client;
+        const late = resolveEnvConfig();
+        if (!late.ok)
+            return formatMissingEnvMessage(late.missing);
+        client = new VeloCmsClient(late.config);
+        return client;
+    }
     const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
     for (const [name, tool] of Object.entries(tools)) {
         server.registerTool(name, {
@@ -40,8 +58,12 @@ async function main() {
             description: tool.description,
             inputSchema: tool.inputSchema,
         }, async (args) => {
+            const resolved = requireClient();
+            if (typeof resolved === "string") {
+                return { content: [{ type: "text", text: resolved }], isError: true };
+            }
             try {
-                const result = await tool.handler(client, (args ?? {}));
+                const result = await tool.handler(resolved, (args ?? {}));
                 return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
             }
             catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velocms/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for VeloCMS — draft, publish, and manage your blog (posts, media, comments, members) from Claude Code, Claude Desktop, Cursor, or any MCP client.",
   "type": "module",
   "license": "MIT",
@@ -48,17 +48,20 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.24.1"
+    "@modelcontextprotocol/sdk": "1.22.0",
+    "zod": "3.25.76"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",
-    "typescript": "^5.6.0",
+    "typescript": "5.6.3",
     "vitest": "^2.1.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "mcpName": "org.velocms/mcp"
+  "mcpName": "org.velocms/mcp",
+  "overrides": {
+    "zod": "3.25.76"
+  }
 }