@taocompany/magic-grid-mcp 0.14.1 → 0.14.3

package/bin/magic-grid-mcp.js

@@ -1,7 +1,20 @@
-#!/usr/bin/env node
-import { runMcpServer } from '../dist/mcpServer.js'
-
-runMcpServer().catch((error) => {
-  console.error(error instanceof Error ? error.message : error)
-  process.exit(1)
-})
+#!/usr/bin/env node
+import { parseMcpServerPath, runMcpServer } from '../dist/mcpServer.js'
+
+const command = process.argv[2]
+if (command === 'check' || command === 'doctor' || command === '--help' || command === '-h') {
+  await import('../dist/cli.js')
+} else {
+  let projectRoot
+  try {
+    projectRoot = parseMcpServerPath(process.argv)
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : error)
+    process.exit(1)
+  }
+
+  runMcpServer(projectRoot).catch((error) => {
+    console.error(error instanceof Error ? error.message : error)
+    process.exit(1)
+  })
+}

package/bin/mgc.js

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
-import '../dist/cli.js'
+#!/usr/bin/env node
+import '../dist/cli.js'

package/dist/cli.js

@@ -1,15 +1,15 @@
 import { resolveManifest, runDoctor } from './resolveManifest.js';
 import { validateMagicGridUsage } from './validate/validateUsage.js';
 function printUsage() {
-    console.log(`@taocompany/magic-grid-mcp · mgc
-
-用法:
-  mgc check [paths...]   静态校验 MagicGrid 用法（默认 ./src）
-  mgc doctor             检查已安装的 magic-grid 与 manifest 解析
-
-示例:
-  npx @taocompany/magic-grid-mcp check ./src
-  npx @taocompany/magic-grid-mcp doctor
+    console.log(`@taocompany/magic-grid-mcp · mgc
+
+用法:
+  mgc check [paths...]   静态校验 MagicGrid 用法（默认 ./src）
+  mgc doctor             检查已安装的 magic-grid 与 manifest 解析
+
+示例:
+  npx @taocompany/magic-grid-mcp check ./src
+  npx @taocompany/magic-grid-mcp doctor
 `);
 }
 async function main() {

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { resolveManifest, runDoctor, findMagicGridPackageRoot, type ResolveManif
 export { getComponentApi } from './tools/getComponentApi.js';
 export { findRecipes } from './tools/findRecipes.js';
 export { createMcpServer, runMcpServer, MCP_TOOL_NAMES } from './mcpServer.js';
+export { parseMcpServerPath } from './parseServerPath.js';
 export type { McpToolName } from './mcpServer.js';
 export { validateMagicGridUsage } from './validate/validateUsage.js';
 export type { ApiManifest, ValidateUsageResult, ValidationIssue, UncheckedItem, } from './types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9E,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -2,4 +2,5 @@ export { resolveManifest, runDoctor, findMagicGridPackageRoot, } from './resolve
 export { getComponentApi } from './tools/getComponentApi.js';
 export { findRecipes } from './tools/findRecipes.js';
 export { createMcpServer, runMcpServer, MCP_TOOL_NAMES } from './mcpServer.js';
+export { parseMcpServerPath } from './parseServerPath.js';
 export { validateMagicGridUsage } from './validate/validateUsage.js';

package/dist/mcpServer.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { parseMcpServerPath } from './parseServerPath.js';
 /** P1 DoD：stdio 暴露的三个 tool（与四家客户端配置文档一致） */
 export declare const MCP_TOOL_NAMES: readonly ["get_component_api", "find_recipes", "validate_magic_grid_usage"];
 export type McpToolName = (typeof MCP_TOOL_NAMES)[number];

package/dist/mcpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../src/mcpServer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAgBnE,4CAA4C;AAC5C,eAAO,MAAM,cAAc,6EAIjB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAgCzD,wBAAgB,eAAe,CAAC,GAAG,SAAgB,GAAG,SAAS,CAwF9D;AAED,wBAAsB,YAAY,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE"}
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../src/mcpServer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAcnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAIzD,4CAA4C;AAC5C,eAAO,MAAM,cAAc,6EAIjB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAgCzD,wBAAgB,eAAe,CAAC,GAAG,SAAgB,GAAG,SAAS,CAwF9D;AAED,wBAAsB,YAAY,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE"}

package/dist/mcpServer.js

@@ -8,6 +8,7 @@ import { getComponentApi, } from './tools/getComponentApi.js';
 import { findRecipes } from './tools/findRecipes.js';
 import { readMcpPackageVersion } from './packageVersion.js';
 import { validateMagicGridUsage } from './validate/validateUsage.js';
+export { parseMcpServerPath } from './parseServerPath.js';
 const SERVER_VERSION = readMcpPackageVersion();
 /** P1 DoD：stdio 暴露的三个 tool（与四家客户端配置文档一致） */
 export const MCP_TOOL_NAMES = [

package/dist/parseServerPath.d.ts

@@ -0,0 +1,11 @@
+/** MCP 入口解析失败。在接入 stdio 之前由 bin 打到 stderr 并退出。 */
+export declare class McpServerPathError extends Error {
+    constructor(message: string);
+}
+/**
+ * 从 MCP 进程 argv 解析项目根。
+ * `argv` 与 `process.argv` 相同：`[node, script, ...args]`。
+ * 没有 `--path` 时返回 `cwd`。
+ */
+export declare function parseMcpServerPath(argv: readonly string[], cwd?: string): string;
+//# sourceMappingURL=parseServerPath.d.ts.map

package/dist/parseServerPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseServerPath.d.ts","sourceRoot":"","sources":["../src/parseServerPath.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,SAAgB,GAAG,MAAM,CAuBvF"}

package/dist/parseServerPath.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/** MCP 入口解析失败。在接入 stdio 之前由 bin 打到 stderr 并退出。 */
+export class McpServerPathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'McpServerPathError';
+    }
+}
+/**
+ * 从 MCP 进程 argv 解析项目根。
+ * `argv` 与 `process.argv` 相同：`[node, script, ...args]`。
+ * 没有 `--path` 时返回 `cwd`。
+ */
+export function parseMcpServerPath(argv, cwd = process.cwd()) {
+    const args = argv.slice(2);
+    const index = args.indexOf('--path');
+    if (index === -1) {
+        return path.resolve(cwd);
+    }
+    const value = args[index + 1];
+    if (value === undefined || value.trim() === '' || value.startsWith('--')) {
+        throw new McpServerPathError('--path 后面需要一个已存在的目录');
+    }
+    const resolved = path.resolve(cwd, value);
+    let stat;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch {
+        throw new McpServerPathError(`--path 不是已存在的目录：${resolved}`);
+    }
+    if (!stat.isDirectory()) {
+        throw new McpServerPathError(`--path 不是已存在的目录：${resolved}`);
+    }
+    return resolved;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taocompany/magic-grid-mcp",
-  "version": "0.14.1",
+  "version": "0.14.3",
   "description": "CLI and MCP tools for validating @taocompany/magic-grid usage",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "test:run": "vitest run"
   },
   "peerDependencies": {
-    "@taocompany/magic-grid": "0.14.1"
+    "@taocompany/magic-grid": "0.14.3"
   },
   "peerDependenciesMeta": {
     "@taocompany/magic-grid": {