mcpill 1.6.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.8.0
+
+- `mcpill run` (stdio) now auto-registers the server in Claude config on start and auto-unregisters on SIGINT, SIGTERM, and process exit — no manual step required
+- `--register` flag and `mcpill unregister` command removed; lifecycle management is now automatic
+
+## 1.7.0
+
+- `mcpill run` is now side-effect-free by default — stopping the process disconnects the server; no Claude config is written
+- `mcpill run --register` retains the old persistent behavior: registers the server entry in Claude config so Claude manages the process
+- `mcpill unregister` removes the server entry from `.claude/settings.json`, `~/.claude.json`, and Claude Desktop config
+
 ## 1.6.0
 
 - `HELLO-MCP.md` template (scaffolded by `mcpill init`) now includes a commented-out `## Hook:` section stub with inline field explanations for all four Claude Code event types

package/README.md

@@ -20,7 +20,7 @@ Describe your server in plain English, let Claude generate the source files.
 mcpill init                        # scaffolds PILL.md + example source files
 # fill PILL.md                     # describe your server: tools, resources, prompts
 # tell Claude: "Build this PILL.md" # agent generates source files + runs compile
-mcpill run                         # start the server
+mcpill run                         # start the server — registered while running, removed on exit
 ```
 
 `PILL.md` embeds the agent instructions — Claude knows exactly what to generate and how.
@@ -31,7 +31,7 @@ mcpill run                         # start the server
 mcpill init          # scaffolds server.md + tools/ + prompts/
 # edit source files  # tools/*.md, prompts/*.md, server.md
 mcpill compile       # compile source → .{name}/ pill artifact
-mcpill run           # start the server
+mcpill run           # start the server (transient — stops when you do)
 ```
 
 ---
@@ -87,10 +87,12 @@ Validates all pill directories (`.<name>/`) in the project root.
 Starts the MCP server from the pill artifact.
 
 ```bash
-mcpill run                        # stdio (default)
+mcpill run                        # stdio (default) — registered while running, removed on exit
 mcpill run --transport http --port 3333
 ```
 
+For stdio transport, the server entry is automatically written to Claude's config on start and removed on exit (SIGINT, SIGTERM, or normal process exit). HTTP transport is self-hosted — Claude connects to a URL, so no registration occurs.
+
 ### `mcpill pack`
 
 Prepares the pill for npm distribution:

package/dist/cli.js

@@ -548,6 +548,7 @@ async function runInit(opts) {
 // src/commands/run.ts
 import path7 from "path";
 import fs6 from "fs";
+import os from "os";
 import { z as z2 } from "mcpill-runtime";
 import { createServer, applySetup } from "mcpster";
 
@@ -1106,6 +1107,32 @@ async function runValidate(baseDir) {
 }
 
 // src/commands/run.ts
+function patchJson(filePath, patcher) {
+  if (!fs6.existsSync(filePath)) return;
+  try {
+    const obj = JSON.parse(fs6.readFileSync(filePath, "utf-8"));
+    patcher(obj);
+    fs6.writeFileSync(filePath, JSON.stringify(obj, null, 2) + "\n", "utf-8");
+  } catch {
+  }
+}
+function desktopConfigPaths() {
+  const home = os.homedir();
+  if (process.platform === "win32") {
+    const appData = process.env.APPDATA ?? path7.join(home, "AppData", "Roaming");
+    return [path7.join(appData, "Claude", "claude_desktop_config.json")];
+  }
+  return [path7.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json")];
+}
+function unregisterSync(name, baseDir) {
+  const remove = (obj) => {
+    const servers = obj.mcpServers;
+    if (servers) delete servers[name];
+  };
+  patchJson(path7.join(baseDir, ".claude", "settings.json"), remove);
+  patchJson(path7.join(os.homedir(), ".claude.json"), remove);
+  for (const p of desktopConfigPaths()) patchJson(p, remove);
+}
 async function runServer(opts) {
   const baseDir = path7.resolve(opts.dir ?? process.cwd());
   await runValidate(baseDir);
@@ -1157,15 +1184,27 @@ async function runServer(opts) {
       resolver: async () => content
     });
   }
-  applySetup(name, tools.map((t) => t.name), {
-    projectPath: baseDir,
-    permissions: "restrictive",
-    register: true,
-    cmdOverride: {
-      command: "mcpill",
-      args: ["run", "--dir", baseDir]
-    }
-  });
+  if (transport === "stdio") {
+    applySetup(name, tools.map((t) => t.name), {
+      projectPath: baseDir,
+      permissions: "restrictive",
+      register: true,
+      cmdOverride: {
+        command: "mcpill",
+        args: ["run", "--dir", baseDir]
+      }
+    });
+    const cleanup = () => unregisterSync(name, baseDir);
+    process.on("exit", cleanup);
+    process.on("SIGINT", () => {
+      cleanup();
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      cleanup();
+      process.exit(0);
+    });
+  }
   try {
     await server.start();
   } catch (err) {
@@ -1569,7 +1608,7 @@ program.name("mcpill").version(pkg.version);
 program.command("init").description("Scaffold a new .mcpill/ directory").option("--dir <path>", "Target directory").action(async (opts) => {
   await runInit(opts);
 });
-program.command("run").description("Start the MCP server").option("--transport <transport>", "Transport type: stdio or http").option("--port <n>", "Port number (HTTP only)", parseInt).option("--dir <path>", "Directory containing .mcpill/").action(
+program.command("run").description("Start the MCP server").option("--transport <type>", "Transport: stdio (default) or http").option("--port <n>", "Port number (HTTP only)", parseInt).option("--dir <path>", "Project root containing .mcpill/").action(
   async (opts) => {
     await runServer(opts);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpill",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "type": "module",
   "description": "CLI for building, validating, and publishing MCP servers using the pill format.",
   "homepage": "https://mcpill.ruco.dev",