@multicomma/arkcn 0.1.0

package/mcp/server.mjs

@@ -0,0 +1,149 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
+import { z } from "zod"
+import { add, findConflicts, missingDependencies, writeItem } from "../cli/commands.mjs"
+import { createRegistry } from "../cli/registry.mjs"
+import { mergeComponentCss, readConfig, readPackageJson, targetPath } from "../cli/project.mjs"
+
+/**
+ * MCP server over the same registry the CLI uses. Tools let an agent browse components,
+ * read their source and documentation, plan an install, and copy components into a project.
+ */
+export async function startServer({ registryBase } = {}) {
+  const registry = createRegistry(registryBase ?? process.env.ARKCN_REGISTRY)
+  const index = await registry.index()
+  const server = new McpServer({ name: "arkcn", version: index.version })
+  const text = (value) => ({
+    content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }],
+  })
+
+  server.registerTool(
+    "list_components",
+    {
+      title: "List components",
+      description: "Every item in the arkcn registry (name, type, description, dependencies). Types: ui, lib, hook.",
+      inputSchema: { type: z.enum(["ui", "lib", "hook", "all"]).default("ui") },
+    },
+    async ({ type }) => text(index.items.filter((i) => type === "all" || i.type === type))
+  )
+
+  server.registerTool(
+    "search_components",
+    {
+      title: "Search components",
+      description: "Find registry items whose name, description, or documentation mentions the query.",
+      inputSchema: { query: z.string().min(1) },
+    },
+    async ({ query }) => {
+      const q = query.toLowerCase()
+      const hits = []
+      for (const entry of index.items) {
+        const item = await registry.item(entry.name)
+        const hay = `${item.name} ${item.description} ${item.docs ?? ""}`.toLowerCase()
+        if (hay.includes(q)) hits.push({ name: item.name, type: item.type, description: item.description })
+      }
+      return text(hits)
+    }
+  )
+
+  server.registerTool(
+    "get_component",
+    {
+      title: "Get component",
+      description:
+        "Full registry item: source files, packages, toolkit dependencies, CSS fragment, and documentation for one component, lib module, or hook.",
+      inputSchema: { name: z.string(), includeSource: z.boolean().default(true) },
+    },
+    async ({ name, includeSource }) => {
+      const item = await registry.item(name)
+      if (!item) return text({ error: `Unknown item: ${name}` })
+      return text(includeSource ? item : { ...item, files: item.files.map((f) => f.path) })
+    }
+  )
+
+  server.registerTool(
+    "get_docs",
+    {
+      title: "Get documentation",
+      description: "The documentation section for a component: anatomy, props, data attributes, keyboard, gotchas.",
+      inputSchema: { name: z.string() },
+    },
+    async ({ name }) => {
+      const item = await registry.item(name)
+      if (!item) return text({ error: `Unknown item: ${name}` })
+      return text(item.docs ?? item.description ?? "No documentation.")
+    }
+  )
+
+  server.registerTool(
+    "plan_install",
+    {
+      title: "Plan an install",
+      description:
+        "Without writing anything: which files `add` would write into a project, which exist and differ, and which packages it would install. `cwd` is the project root (must contain arkcn.json).",
+      inputSchema: { names: z.array(z.string()).min(1), cwd: z.string() },
+    },
+    async ({ names, cwd }) => {
+      const config = readConfig(cwd)
+      if (!config) return text({ error: `No arkcn.json in ${cwd}. Run \`npx @multicomma/arkcn init\` there first.` })
+      const { items, missing } = await registry.closure(names)
+      return text({
+        missing,
+        files: items.flatMap((i) => i.files.map((f) => targetPath(config, f.path))),
+        conflicts: findConflicts(cwd, config, items),
+        packages: missingDependencies(cwd, items),
+        css: items.filter((i) => i.css).map((i) => i.name),
+      })
+    }
+  )
+
+  server.registerTool(
+    "add_components",
+    {
+      title: "Add components",
+      description:
+        "Copy components (with everything they import) into a project, merge their CSS, and report which packages to install. Does not run the package manager. Existing files that differ are kept unless `overwrite` is true.",
+      inputSchema: { names: z.array(z.string()).min(1), cwd: z.string(), overwrite: z.boolean().default(false) },
+    },
+    async ({ names, cwd, overwrite }) => {
+      const config = readConfig(cwd)
+      if (!config) return text({ error: `No arkcn.json in ${cwd}. Run \`npx @multicomma/arkcn init\` there first.` })
+      if (!readPackageJson(cwd)) return text({ error: `No package.json in ${cwd}` })
+      const { items, missing } = await registry.closure(names)
+      if (missing.length) return text({ error: `Unknown: ${missing.join(", ")}` })
+      const written = []
+      const kept = []
+      const css = []
+      for (const item of items) {
+        const r = writeItem(cwd, config, item, { overwrite })
+        written.push(...r.written)
+        kept.push(...r.kept)
+        if (item.css && mergeComponentCss(cwd, config, item.name, item.css) !== "unchanged") css.push(item.name)
+      }
+      const packages = missingDependencies(cwd, items)
+      return text({
+        written,
+        kept,
+        css,
+        packages,
+        next: packages.length ? `Install: npm install ${packages.join(" ")}` : "No new packages needed.",
+      })
+    }
+  )
+
+  server.registerResource(
+    "registry-index",
+    "arkcn://registry/index",
+    { title: "Registry index", description: "All arkcn items", mimeType: "application/json" },
+    async (uri) => ({
+      contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(index, null, 2) }],
+    })
+  )
+
+  const transport = new StdioServerTransport()
+  await server.connect(transport)
+  return server
+}
+
+// `add` is re-exported for parity checks; the CLI remains the interactive path.
+void add

package/package.json

@@ -0,0 +1,201 @@
+{
+  "name": "@multicomma/arkcn",
+  "version": "0.1.0",
+  "description": "arkcn: shadcn/ui-style components ported to Ark UI, plus data-heavy primitives (data grid, kanban, gantt, scheduler, node graph, ...). Tailwind v4. Ships a copy-into-your-project CLI and an MCP server.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "src",
+    "bin",
+    "cli",
+    "mcp",
+    "registry",
+    "README.md"
+  ],
+  "exports": {
+    "./ui/*": "./src/components/ui/*.tsx",
+    "./lib/*": "./src/lib/*.ts",
+    "./hooks/*": "./src/hooks/*.ts",
+    "./styles.css": "./src/styles/arkcn.css",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint --deny-warnings && node scripts/check-quotes.mjs && node scripts/check-ark-parts.mjs && npm run -s format:check",
+    "format": "prettier --write \"src/**/*.{ts,tsx,css}\" \"{scripts,cli,bin,mcp}/**/*.mjs\" \"*.{json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,css}\" \"{scripts,cli,bin,mcp}/**/*.mjs\" \"*.{json,md}\"",
+    "check": "npm run -s build:registry && npm run -s typecheck && npm run -s lint && npm run -s test:cli",
+    "build:registry": "node scripts/build-registry.mjs",
+    "test:cli": "node scripts/test-cli.mjs",
+    "prepublishOnly": "npm run -s check"
+  },
+  "peerDependencies": {
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "@ark-ui/react": "^5.39.1",
+    "tailwindcss": "^4.3.3",
+    "lucide-react": "^1.41.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.6.0",
+    "class-variance-authority": "^0.7.1",
+    "tw-animate-css": "^1.4.0",
+    "@tailwindcss/typography": "^0.5.20",
+    "@atlaskit/pragmatic-drag-and-drop": "^3.1.0",
+    "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "^3.2.0",
+    "@atlaskit/pragmatic-drag-and-drop-hitbox": "^2.2.0",
+    "@tiptap/extension-highlight": "^3.31.3",
+    "@tiptap/extension-image": "^3.31.3",
+    "@tiptap/extension-table": "^3.31.3",
+    "@tiptap/extension-table-cell": "^3.31.3",
+    "@tiptap/extension-table-header": "^3.31.3",
+    "@tiptap/extension-table-row": "^3.31.3",
+    "@tiptap/extension-task-item": "^3.31.3",
+    "@tiptap/extension-task-list": "^3.31.3",
+    "@tiptap/extension-text-align": "^3.31.3",
+    "@tiptap/extensions": "^3.31.3",
+    "@tiptap/pm": "^3.31.3",
+    "@tiptap/react": "^3.31.3",
+    "@tiptap/starter-kit": "^3.31.3",
+    "date-fns": "^4.4.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.5.0",
+    "next-themes": "^0.4.6",
+    "react-day-picker": "^10.0.1",
+    "react-resizable-panels": "^4.12.3",
+    "recharts": "^3.8.0",
+    "sonner": "^2.0.8"
+  },
+  "peerDependenciesMeta": {
+    "@atlaskit/pragmatic-drag-and-drop": {
+      "optional": true
+    },
+    "@atlaskit/pragmatic-drag-and-drop-auto-scroll": {
+      "optional": true
+    },
+    "@atlaskit/pragmatic-drag-and-drop-hitbox": {
+      "optional": true
+    },
+    "@tiptap/extension-highlight": {
+      "optional": true
+    },
+    "@tiptap/extension-image": {
+      "optional": true
+    },
+    "@tiptap/extension-table": {
+      "optional": true
+    },
+    "@tiptap/extension-table-cell": {
+      "optional": true
+    },
+    "@tiptap/extension-table-header": {
+      "optional": true
+    },
+    "@tiptap/extension-table-row": {
+      "optional": true
+    },
+    "@tiptap/extension-task-item": {
+      "optional": true
+    },
+    "@tiptap/extension-task-list": {
+      "optional": true
+    },
+    "@tiptap/extension-text-align": {
+      "optional": true
+    },
+    "@tiptap/extensions": {
+      "optional": true
+    },
+    "@tiptap/pm": {
+      "optional": true
+    },
+    "@tiptap/react": {
+      "optional": true
+    },
+    "@tiptap/starter-kit": {
+      "optional": true
+    },
+    "date-fns": {
+      "optional": true
+    },
+    "embla-carousel-react": {
+      "optional": true
+    },
+    "input-otp": {
+      "optional": true
+    },
+    "next-themes": {
+      "optional": true
+    },
+    "react-day-picker": {
+      "optional": true
+    },
+    "react-resizable-panels": {
+      "optional": true
+    },
+    "recharts": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "@ark-ui/react": "^5.39.1",
+    "tailwindcss": "^4.3.3",
+    "lucide-react": "^1.41.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.6.0",
+    "class-variance-authority": "^0.7.1",
+    "tw-animate-css": "^1.4.0",
+    "@tailwindcss/typography": "^0.5.20",
+    "@atlaskit/pragmatic-drag-and-drop": "^3.1.0",
+    "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "^3.2.0",
+    "@atlaskit/pragmatic-drag-and-drop-hitbox": "^2.2.0",
+    "@tiptap/extension-highlight": "^3.31.3",
+    "@tiptap/extension-image": "^3.31.3",
+    "@tiptap/extension-table": "^3.31.3",
+    "@tiptap/extension-table-cell": "^3.31.3",
+    "@tiptap/extension-table-header": "^3.31.3",
+    "@tiptap/extension-table-row": "^3.31.3",
+    "@tiptap/extension-task-item": "^3.31.3",
+    "@tiptap/extension-task-list": "^3.31.3",
+    "@tiptap/extension-text-align": "^3.31.3",
+    "@tiptap/extensions": "^3.31.3",
+    "@tiptap/pm": "^3.31.3",
+    "@tiptap/react": "^3.31.3",
+    "@tiptap/starter-kit": "^3.31.3",
+    "date-fns": "^4.4.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.5.0",
+    "next-themes": "^0.4.6",
+    "react-day-picker": "^10.0.1",
+    "react-resizable-panels": "^4.12.3",
+    "recharts": "^3.8.0",
+    "sonner": "^2.0.8",
+    "@types/node": "^24.13.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "eslint-plugin-better-tailwindcss": "^4.7.0",
+    "oxlint": "^1.79.0",
+    "prettier": "^3.9.6",
+    "prettier-plugin-tailwindcss": "^0.8.1",
+    "typescript": "~6.0.2"
+  },
+  "bin": {
+    "arkcn": "bin/arkcn.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.5.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itsdanreed/arkcn.git"
+  }
+}