@matthesketh/utopia-cli 0.7.0 → 0.7.2

package/dist/index.js

@@ -3,7 +3,9 @@
 // src/index.ts
 import { existsSync } from "fs";
 import { resolve } from "path";
+import { createInterface } from "readline";
 import { createRequire } from "module";
+import { execSync } from "child_process";
 import {
   createServer,
   build as viteBuild,
@@ -103,6 +105,160 @@ async function test(args) {
   });
   await vitest?.close();
 }
+var CONTENT_CONFIG_FILES = [
+  "content.config.ts",
+  "content.config.js",
+  "content.config.mjs",
+  "content.config.mts"
+];
+function findContentConfig() {
+  return CONTENT_CONFIG_FILES.find((f) => existsSync(resolve(process.cwd(), f)));
+}
+async function mcpServe() {
+  const configFile = findContentConfig();
+  if (!configFile) {
+    process.stderr.write(
+      "No content.config found. utopia mcp serve requires @matthesketh/utopia-content.\n"
+    );
+    process.exit(1);
+  }
+  const server = await createServer({
+    mode: "production",
+    logLevel: "silent",
+    server: { middlewareMode: true },
+    plugins: [utopia()]
+  });
+  let handleRequest;
+  try {
+    await server.ssrLoadModule(resolve(process.cwd(), configFile));
+    const content = await server.ssrLoadModule("@matthesketh/utopia-content");
+    const names = content.listCollections();
+    if (names.length === 0) {
+      process.stderr.write(
+        "No collections defined. Add defineCollection() calls to your config.\n"
+      );
+      process.exit(1);
+    }
+    const contentMcp = await server.ssrLoadModule("@matthesketh/utopia-content/mcp");
+    const collectionMap = /* @__PURE__ */ new Map();
+    for (const name of names) {
+      const col = content.getCollectionAdapter(name);
+      if (col) collectionMap.set(name, col);
+    }
+    const tools = contentMcp.createContentTools(() => collectionMap);
+    const toolMap = new Map(tools.map((t) => [t.definition.name, t]));
+    const serverInfo = { name: "utopia-content", version: "1.0.0" };
+    handleRequest = async (request) => {
+      try {
+        let result;
+        switch (request.method) {
+          case "initialize":
+            result = {
+              protocolVersion: "2024-11-05",
+              capabilities: { tools: {} },
+              serverInfo
+            };
+            break;
+          case "tools/list":
+            result = {
+              tools: tools.map((t) => ({
+                name: t.definition.name,
+                description: t.definition.description,
+                inputSchema: t.definition.inputSchema
+              }))
+            };
+            break;
+          case "tools/call": {
+            const params = request.params;
+            const tool = toolMap.get(params.name);
+            if (!tool) {
+              return {
+                jsonrpc: "2.0",
+                id: request.id,
+                error: { code: -32602, message: `Unknown tool: ${params.name}` }
+              };
+            }
+            result = await tool.handler(params.arguments ?? {});
+            break;
+          }
+          case "ping":
+            result = {};
+            break;
+          default:
+            return {
+              jsonrpc: "2.0",
+              id: request.id,
+              error: { code: -32601, message: `Method not found: ${request.method}` }
+            };
+        }
+        return { jsonrpc: "2.0", id: request.id, result };
+      } catch (err) {
+        const e = err;
+        return {
+          jsonrpc: "2.0",
+          id: request.id,
+          error: { code: e.code ?? -32603, message: e.message ?? "Internal error" }
+        };
+      }
+    };
+  } catch (err) {
+    await server.close();
+    throw err;
+  }
+  await server.close();
+  const rl = createInterface({ input: process.stdin });
+  for await (const line of rl) {
+    if (!line.trim()) continue;
+    try {
+      const request = JSON.parse(line);
+      if (request.id == null) continue;
+      const response = await handleRequest(request);
+      process.stdout.write(JSON.stringify(response) + "\n");
+    } catch {
+    }
+  }
+}
+function mcpInstall() {
+  try {
+    execSync("claude --version", { stdio: "ignore" });
+  } catch {
+    console.error(
+      "Claude Code CLI not found. Install it first: npm i -g @anthropic-ai/claude-code"
+    );
+    process.exit(1);
+  }
+  try {
+    execSync("claude mcp add utopia-content -s project -- npx utopia mcp serve", {
+      stdio: "inherit",
+      cwd: process.cwd()
+    });
+    console.log("\nUtopiaJS MCP server registered with Claude Code.");
+    console.log("Claude Code can now manage your content collections.");
+  } catch (err) {
+    const e = err;
+    console.error("Failed to register MCP server:", e.message);
+    process.exit(1);
+  }
+}
+function printMcpHelp() {
+  console.log(`
+  utopia mcp \u2014 MCP server for Claude Code integration
+
+  Usage:
+    utopia mcp <subcommand>
+
+  Subcommands:
+    install  Register the UtopiaJS content MCP server with Claude Code
+    serve    Start the MCP server over stdio (used by Claude Code)
+
+  The MCP server exposes your content collections as tools:
+    list_collections, list_entries, get_entry, create_entry,
+    update_entry, delete_entry, search_entries, list_tags, publish_entry
+
+  Quick start:
+    utopia mcp install
+`);
+}
 function printVersion() {
   const require2 = createRequire(import.meta.url);
   const pkg = require2("../package.json");
@@ -120,6 +276,7 @@ function printHelp() {
     build    Build for production
     preview  Preview production build
     test     Run component tests
+    mcp      Claude Code MCP server integration
     create   Create a new project
 
   Options:
@@ -147,6 +304,13 @@ async function main() {
     case "test":
       await test(args);
       break;
+    case "mcp": {
+      const sub = args.rest[0];
+      if (sub === "serve") await mcpServe();
+      else if (sub === "install") mcpInstall();
+      else printMcpHelp();
+      break;
+    }
     case "create":
       console.log("To create a new UtopiaJS project, run:");
       console.log("  npx create-utopia [project-name]");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matthesketh/utopia-cli",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "CLI for the UtopiaJS framework",
   "type": "module",
   "license": "MIT",
@@ -30,9 +30,13 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm",
+    "dev": "tsup src/index.ts --format esm --watch"
+  },
   "dependencies": {
-    "@matthesketh/utopia-test": "0.7.0",
-    "@matthesketh/utopia-vite-plugin": "0.7.0"
+    "@matthesketh/utopia-vite-plugin": "^0.7.x",
+    "@matthesketh/utopia-test": "^0.7.x"
   },
   "peerDependencies": {
     "vite": "^6.0.0 || ^7.0.0",
@@ -40,9 +44,5 @@
   },
   "devDependencies": {
     "vite": "^7.3.1"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm",
-    "dev": "tsup src/index.ts --format esm --watch"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Matt Hesketh
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.