openuispec 0.1.35 → 0.1.37

package/README.md

@@ -257,14 +257,14 @@ OpenUISpec includes an MCP (Model Context Protocol) server that exposes CLI comm
 {
   "mcpServers": {
     "openuispec": {
-      "command": "npx",
-      "args": ["openuispec-mcp"]
+      "command": "openuispec",
+      "args": ["mcp"]
     }
   }
 }
 ```
 
-Or run directly: `npx openuispec-mcp`
+Or run directly: `openuispec mcp`
 
 Set `OPENUISPEC_PROJECT_DIR` to override the working directory.
 

package/cli/index.ts

@@ -94,6 +94,12 @@ async function main(): Promise<void> {
       break;
     }
 
+    case "mcp": {
+      const { startMcpServer } = await import("../mcp-server/index.js");
+      await startMcpServer();
+      break;
+    }
+
     case undefined:
     case "--help":
     case "-h":
@@ -117,6 +123,7 @@ Usage:
   openuispec check --target <t> [--json]    Composite validation + prepare readiness
   openuispec validate [group...] [--json]   Validate spec files
   openuispec validate semantic --json       Semantic validation as JSON
+  openuispec mcp                           Start MCP server (stdio transport)
 
 Validate groups: manifest, tokens, screens, flows, platform, locales, contracts, semantic
 

package/cli/init.ts

@@ -471,11 +471,18 @@ export function updateRules(): void {
   }
 
   // Ensure MCP server is configured
+  configureMcp(cwd, true);
+}
+
+// ── shared MCP config ───────────────────────────────────────────────
+
+const EXPECTED_MCP_CONFIG = {
+  command: "openuispec",
+  args: ["mcp"],
+};
+
+function configureMcp(cwd: string, showRestart: boolean, quiet: boolean = false): void {
   const claudeJsonPath = join(cwd, ".claude.json");
-  const mcpConfig = {
-    command: "npx",
-    args: ["openuispec-mcp"],
-  };
 
   try {
     let claudeJson: Record<string, any> = {};
@@ -484,14 +491,25 @@ export function updateRules(): void {
     } catch {
       // file doesn't exist or isn't valid JSON — start fresh
     }
+
     if (!claudeJson.mcpServers) claudeJson.mcpServers = {};
-    if (!claudeJson.mcpServers.openuispec) {
-      claudeJson.mcpServers.openuispec = mcpConfig;
+
+    const existing = claudeJson.mcpServers.openuispec;
+    const needsUpdate =
+      !existing ||
+      existing.command !== EXPECTED_MCP_CONFIG.command ||
+      JSON.stringify(existing.args) !== JSON.stringify(EXPECTED_MCP_CONFIG.args);
+
+    if (needsUpdate) {
+      claudeJson.mcpServers.openuispec = { ...EXPECTED_MCP_CONFIG };
       writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2) + "\n");
-      console.log(`  create .claude.json (MCP server configured)`);
+      if (!quiet) console.log(`  ${existing ? "update" : "create"} .claude.json (MCP server configured)`);
+      if (showRestart) console.log(`\n  Restart Claude Code to activate the MCP server.`);
+    } else {
+      if (!quiet) console.log(`  skip .claude.json (openuispec MCP already configured)`);
     }
   } catch {
-    // non-critical — skip silently
+    if (!quiet) console.log(`  skip .claude.json (could not configure MCP server)`);
   }
 }
 
@@ -760,30 +778,7 @@ export async function init(argv: string[] = []): Promise<void> {
 
     // ── MCP server configuration ────────────────────────────────────
 
-    const claudeJsonPath = join(cwd, ".claude.json");
-    const mcpConfig = {
-      command: "npx",
-      args: ["openuispec-mcp"],
-    };
-
-    try {
-      let claudeJson: Record<string, any> = {};
-      try {
-        claudeJson = JSON.parse(readFileSync(claudeJsonPath, "utf-8"));
-      } catch {
-        // file doesn't exist or isn't valid JSON — start fresh
-      }
-      if (!claudeJson.mcpServers) claudeJson.mcpServers = {};
-      if (!claudeJson.mcpServers.openuispec) {
-        claudeJson.mcpServers.openuispec = mcpConfig;
-        writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2) + "\n");
-        if (!quiet) console.log(`  create .claude.json (MCP server configured)`);
-      } else {
-        if (!quiet) console.log(`  skip .claude.json (openuispec MCP already configured)`);
-      }
-    } catch {
-      if (!quiet) console.log(`  skip .claude.json (could not configure MCP server)`);
-    }
+    configureMcp(cwd, false, quiet);
 
     if (answers.configureTargets) {
       if (!quiet) console.log("\nConfiguring target stacks...\n");

package/mcp-server/index.ts

@@ -172,12 +172,19 @@ server.registerTool(
 
 // ── start server ─────────────────────────────────────────────────────
 
-async function main() {
+export async function startMcpServer() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
 
-main().catch((err) => {
-  console.error("Failed to start OpenUISpec MCP server:", err);
-  process.exit(1);
-});
+// Direct execution (npx openuispec-mcp)
+const isDirectRun =
+  process.argv[1]?.endsWith("mcp-server/index.ts") ||
+  process.argv[1]?.endsWith("mcp-server/index.js");
+
+if (isDirectRun) {
+  startMcpServer().catch((err) => {
+    console.error("Failed to start OpenUISpec MCP server:", err);
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openuispec",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "license": "MIT",
   "type": "module",
   "description": "A semantic UI specification format for AI-native, platform-native app development",