@vizejs/musea-mcp-server 0.33.0 → 0.34.0

package/dist/{cli.js → cli.mjs}

@@ -1,7 +1,16 @@
 #!/usr/bin/env node
-import { startServer } from "./src-BY8aIu75.js";
-
+import { n as startServer } from "./src-DqveCZc0.mjs";
 //#region src/cli.ts
+/**
+* Musea MCP Server CLI.
+*
+* Usage:
+*   musea-mcp [project-root] [--tokens-path <path>]
+*
+* Environment:
+*   MUSEA_PROJECT_ROOT - Project root directory (default: cwd)
+*   MUSEA_TOKENS_PATH  - Path to design tokens file/directory
+*/
 let projectRoot = process.env.MUSEA_PROJECT_ROOT || process.cwd();
 let tokensPath = process.env.MUSEA_TOKENS_PATH;
 const args = process.argv.slice(2);
@@ -13,5 +22,5 @@ startServer(projectRoot, { tokensPath }).catch((error) => {
 	console.error("[musea-mcp] Failed to start:", error);
 	process.exit(1);
 });
-
-//#endregion
+//#endregion
+export {};

package/dist/{index.d.ts → index.d.mts}

@@ -1,7 +1,6 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 
 //#region src/index.d.ts
-
 declare function createMuseaServer(config: {
   projectRoot: string;
   include?: string[];
@@ -10,5 +9,6 @@ declare function createMuseaServer(config: {
 }): Server;
 declare function startServer(projectRoot: string, options?: {
   tokensPath?: string;
-}): Promise<void>; //#endregion
+}): Promise<void>;
+//#endregion
 export { createMuseaServer, createMuseaServer as default, startServer };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { n as startServer, t as createMuseaServer } from "./src-DqveCZc0.mjs";
+export { createMuseaServer, createMuseaServer as default, startServer };

package/dist/{src-BY8aIu75.js → src-DqveCZc0.mjs}

@@ -1,10 +1,9 @@
+import { createRequire } from "node:module";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ErrorCode, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import fs from "node:fs";
 import path from "node:path";
-import { createRequire } from "node:module";
-
 //#region src/native.ts
 let native = null;
 function loadNative() {
@@ -17,7 +16,6 @@ function loadNative() {
 		throw new Error(`Failed to load @vizejs/native. Make sure it's installed: ${String(e)}`);
 	}
 }
-
 //#endregion
 //#region src/scanner.ts
 async function findArtFiles(root, include, exclude) {
@@ -49,7 +47,6 @@ function matchGlob(filepath, pattern) {
 	const regex = pattern.replace(/\*\*/g, "{{DOUBLE_STAR}}").replace(/\*/g, "[^/]*").replace(/{{DOUBLE_STAR}}/g, ".*").replace(/\./g, "\\.");
 	return new RegExp(`^${regex}$`).test(filepath);
 }
-
 //#endregion
 //#region src/tools/definitions.ts
 /**
@@ -243,9 +240,13 @@ const toolDefinitions = [
 		}
 	}
 ];
-
 //#endregion
 //#region src/tools/handler/analysis.ts
+/**
+* MCP tool handlers for component analysis.
+*
+* Handles `analyze_component` and `get_palette` tool calls.
+*/
 async function handleAnalyzeComponent(ctx, binding, args) {
 	const vuePath = args?.path;
 	if (!vuePath) throw new McpError(ErrorCode.InvalidParams, "path is required");
@@ -293,9 +294,14 @@ async function handleGetPalette(ctx, binding, args) {
 		}, null, 2)
 	}] };
 }
-
 //#endregion
 //#region src/tools/handler/registry.ts
+/**
+* MCP tool handlers for the component registry.
+*
+* Handles `list_components`, `get_component`, `get_variant`, and
+* `search_components` tool calls.
+*/
 async function handleListComponents(ctx, args) {
 	const arts = await ctx.scanArtFiles();
 	let results = Array.from(arts.values());
@@ -342,8 +348,7 @@ async function handleGetVariant(ctx, binding, args) {
 	if (!artPath || !variantName) throw new McpError(ErrorCode.InvalidParams, "path and variant are required");
 	const absolutePath = path.resolve(ctx.projectRoot, artPath);
 	const source = await fs.promises.readFile(absolutePath, "utf-8");
-	const parsed = binding.parseArt(source, { filename: absolutePath });
-	const variant = parsed.variants.find((v) => v.name.toLowerCase() === variantName.toLowerCase());
+	const variant = binding.parseArt(source, { filename: absolutePath }).variants.find((v) => v.name.toLowerCase() === variantName.toLowerCase());
 	if (!variant) throw new McpError(ErrorCode.InvalidParams, `Variant "${variantName}" not found`);
 	return { content: [{
 		type: "text",
@@ -372,35 +377,31 @@ async function handleSearchComponents(ctx, args) {
 		})), null, 2)
 	}] };
 }
-
 //#endregion
 //#region src/tokens.ts
 async function parseTokensFromPath(tokensPath) {
-	const stat = await fs.promises.stat(tokensPath);
-	if (stat.isDirectory()) {
+	if ((await fs.promises.stat(tokensPath)).isDirectory()) {
 		const entries = await fs.promises.readdir(tokensPath, { withFileTypes: true });
 		const categories = [];
 		for (const entry of entries) if (entry.isFile() && (entry.name.endsWith(".json") || entry.name.endsWith(".tokens.json"))) {
 			const filePath = path.join(tokensPath, entry.name);
-			const content$1 = await fs.promises.readFile(filePath, "utf-8");
-			const tokens$1 = JSON.parse(content$1);
+			const content = await fs.promises.readFile(filePath, "utf-8");
+			const tokens = JSON.parse(content);
 			const categoryName = path.basename(entry.name, path.extname(entry.name)).replace(".tokens", "");
 			categories.push({
 				name: formatCategoryName(categoryName),
-				tokens: extractTokenValues(tokens$1),
-				subcategories: extractSubcats(tokens$1)
+				tokens: extractTokenValues(tokens),
+				subcategories: extractSubcats(tokens)
 			});
 		}
 		return categories;
 	}
 	const content = await fs.promises.readFile(tokensPath, "utf-8");
-	const tokens = JSON.parse(content);
-	return flattenTokenStructure(tokens);
+	return flattenTokenStructure(JSON.parse(content));
 }
 function generateTokensMarkdown(categories) {
 	const renderCategory = (category, level = 2) => {
-		const heading = "#".repeat(level);
-		let md = `\n${heading} ${category.name}\n\n`;
+		let md = `\n${"#".repeat(level)} ${category.name}\n\n`;
 		if (Object.keys(category.tokens).length > 0) {
 			md += "| Token | Value | Description |\n";
 			md += "|-------|-------|-------------|\n";
@@ -463,9 +464,14 @@ function flattenTokenStructure(tokens) {
 function formatCategoryName(name) {
 	return name.replace(/[-_]/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
 }
-
 //#endregion
 //#region src/tools/handler/generation.ts
+/**
+* MCP tool handlers for code generation.
+*
+* Handles `generate_variants`, `generate_csf`, `generate_docs`,
+* `generate_catalog`, and `get_tokens` tool calls.
+*/
 async function handleGenerateVariants(ctx, binding, args) {
 	const componentRelPath = args?.componentPath;
 	if (!componentRelPath) throw new McpError(ErrorCode.InvalidParams, "componentPath is required");
@@ -473,8 +479,7 @@ async function handleGenerateVariants(ctx, binding, args) {
 	if (!binding.generateVariants) throw new McpError(ErrorCode.InternalError, "generateVariants not available in native binding");
 	const absolutePath = path.resolve(ctx.projectRoot, componentRelPath);
 	const source = await fs.promises.readFile(absolutePath, "utf-8");
-	const analysis = binding.analyzeSfc(source, { filename: absolutePath });
-	const props = analysis.props.map((p) => ({
+	const props = binding.analyzeSfc(source, { filename: absolutePath }).props.map((p) => ({
 		name: p.name,
 		prop_type: p.type,
 		required: p.required,
@@ -506,10 +511,9 @@ async function handleGenerateCsf(ctx, binding, args) {
 	if (!artPath) throw new McpError(ErrorCode.InvalidParams, "path is required");
 	const absolutePath = path.resolve(ctx.projectRoot, artPath);
 	const source = await fs.promises.readFile(absolutePath, "utf-8");
-	const csf = binding.artToCsf(source, { filename: absolutePath });
 	return { content: [{
 		type: "text",
-		text: csf.code
+		text: binding.artToCsf(source, { filename: absolutePath }).code
 	}] };
 }
 async function handleGenerateDocs(ctx, binding, args) {
@@ -573,9 +577,14 @@ async function handleGetTokens(ctx, args) {
 		text: JSON.stringify({ categories }, null, 2)
 	}] };
 }
-
 //#endregion
 //#region src/tools/handler/index.ts
+/**
+* MCP tool call handler for Musea.
+*
+* Routes incoming tool calls to the appropriate handler logic based on
+* the tool name, using the native Rust binding and server context.
+*/
 async function handleToolCall(ctx, name, args) {
 	const binding = ctx.loadNative();
 	switch (name) {
@@ -593,7 +602,6 @@ async function handleToolCall(ctx, name, args) {
 		default: throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
 	}
 }
-
 //#endregion
 //#region src/resources.ts
 async function listResources(ctx) {
@@ -614,8 +622,7 @@ async function listResources(ctx) {
 			mimeType: "text/markdown"
 		});
 	}
-	const resolvedTokensPath = await ctx.resolveTokensPath();
-	if (resolvedTokensPath) resources.push({
+	if (await ctx.resolveTokensPath()) resources.push({
 		uri: "musea://tokens",
 		name: "Design Tokens",
 		description: "Project design tokens (colors, spacing, typography, …)",
@@ -629,8 +636,7 @@ async function readResource(ctx, uri) {
 		const absolutePath = path.resolve(ctx.projectRoot, relativePath);
 		try {
 			const source = await fs.promises.readFile(absolutePath, "utf-8");
-			const binding = ctx.loadNative();
-			const parsed = binding.parseArt(source, { filename: absolutePath });
+			const parsed = ctx.loadNative().parseArt(source, { filename: absolutePath });
 			return { contents: [{
 				uri,
 				mimeType: "application/json",
@@ -659,11 +665,10 @@ async function readResource(ctx, uri) {
 			const source = await fs.promises.readFile(absolutePath, "utf-8");
 			const binding = ctx.loadNative();
 			if (!binding.generateArtDoc) throw new McpError(ErrorCode.InternalError, "generateArtDoc not available in native binding");
-			const doc = binding.generateArtDoc(source, { filename: absolutePath });
 			return { contents: [{
 				uri,
 				mimeType: "text/markdown",
-				text: doc.markdown
+				text: binding.generateArtDoc(source, { filename: absolutePath }).markdown
 			}] };
 		} catch (e) {
 			if (e instanceof McpError) throw e;
@@ -686,9 +691,17 @@ async function readResource(ctx, uri) {
 	}
 	throw new McpError(ErrorCode.InvalidRequest, `Unknown resource URI: ${uri}`);
 }
-
 //#endregion
 //#region src/index.ts
+/**
+* Musea MCP Server — Vue.js design system toolkit.
+*
+* Provides AI assistants with tools to:
+* - Analyze Vue SFC components (props, emits)
+* - Browse and search a component registry
+* - Generate documentation, variants, and Storybook stories
+* - Read and format design tokens
+*/
 function createMuseaServer(config) {
 	const server = new Server({
 		name: "musea-mcp-server",
@@ -701,14 +714,14 @@ function createMuseaServer(config) {
 	const include = config.include ?? ["**/*.art.vue"];
 	const exclude = config.exclude ?? ["node_modules/**", "dist/**"];
 	const tokensPath = config.tokensPath;
-	let artCache = new Map();
+	let artCache = /* @__PURE__ */ new Map();
 	let lastScanTime = 0;
 	async function scanArtFiles() {
 		const now = Date.now();
 		if (now - lastScanTime < 5e3 && artCache.size > 0) return artCache;
 		const binding = loadNative();
 		const files = await findArtFiles(projectRoot, include, exclude);
-		artCache = new Map();
+		artCache = /* @__PURE__ */ new Map();
 		for (const file of files) try {
 			const source = await fs.promises.readFile(file, "utf-8");
 			const parsed = binding.parseArt(source, { filename: file });
@@ -729,12 +742,11 @@ function createMuseaServer(config) {
 	}
 	async function resolveTokensPath() {
 		if (tokensPath) return path.resolve(projectRoot, tokensPath);
-		const candidates = [
+		for (const dir of [
 			"tokens",
 			"design-tokens",
 			"style-dictionary"
-		];
-		for (const dir of candidates) {
+		]) {
 			const candidate = path.join(projectRoot, dir);
 			try {
 				const stat = await fs.promises.stat(candidate);
@@ -764,7 +776,5 @@ async function startServer(projectRoot, options) {
 	await server.connect(transport);
 	console.error("[musea-mcp] Server started");
 }
-var src_default = createMuseaServer;
-
 //#endregion
-export { createMuseaServer, src_default, startServer };
+export { startServer as n, createMuseaServer as t };

package/package.json

@@ -1,57 +1,56 @@
 {
   "name": "@vizejs/musea-mcp-server",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "MCP server for building Vue.js design systems - component analysis, documentation, variant generation, and design tokens",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "musea-mcp": "./dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
   "keywords": [
+    "ai",
+    "component-analysis",
+    "design-system",
     "mcp",
     "model-context-protocol",
-    "vue",
-    "design-system",
-    "component-analysis",
     "musea",
-    "ai"
+    "vue"
   ],
-  "author": "ubugeeei",
   "license": "MIT",
+  "author": "ubugeeei",
   "repository": {
     "type": "git",
     "url": "https://github.com/ubugeeei/vize.git",
     "directory": "npm/musea-mcp-server"
   },
+  "bin": {
+    "musea-mcp": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.5.0",
-    "@vizejs/native": "0.33.0"
+    "@vizejs/native": "0.34.0"
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "tsdown": "^0.9.0",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "public"
+    "typescript": "^5.7.0",
+    "vite-plus": "latest"
   },
   "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
+    "build": "vp pack",
+    "dev": "vp pack --watch",
     "start": "node dist/cli.js",
-    "lint": "oxlint --deny-warnings --type-aware --tsconfig tsconfig.json",
-    "lint:fix": "oxlint --type-aware --tsconfig tsconfig.json --fix",
-    "fmt": "oxfmt --write src tsdown.config.ts",
-    "fmt:check": "oxfmt src tsdown.config.ts"
+    "check": "vp check src vite.config.ts",
+    "check:fix": "vp check --fix src vite.config.ts",
+    "fmt": "vp fmt --write src vite.config.ts"
   }
 }

package/dist/index.js

@@ -1,3 +0,0 @@
-import { createMuseaServer, src_default, startServer } from "./src-BY8aIu75.js";
-
-export { createMuseaServer, src_default as default, startServer };