palette-mcp 1.1.1 → 1.2.0

package/dist/services/design-system.js

@@ -1,9 +1,92 @@
+import { ComponentSyncService } from '../sync/index.js';
 export class DesignSystemService {
     reactComponents = [];
     vueComponents = [];
-    constructor() {
+    syncService;
+    syncConfig;
+    initialized = false;
+    lastSyncResult = null;
+    constructor(syncConfig = {}) {
+        this.syncConfig = {
+            autoSync: syncConfig.autoSync ?? true,
+            verbose: syncConfig.verbose ?? false,
+        };
+        this.syncService = new ComponentSyncService();
+        // 하드코딩된 기본 컴포넌트 초기화 (폴백용)
         this.initializeComponents();
     }
+    /**
+     * 서비스 초기화 (비동기)
+     * 서버 시작 시 호출하여 GitHub에서 최신 컴포넌트 동기화
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        if (this.syncConfig.autoSync) {
+            try {
+                console.log('[DesignSystem] 컴포넌트 동기화 시작...');
+                const result = await this.syncService.sync({
+                    verbose: this.syncConfig.verbose,
+                });
+                this.lastSyncResult = result;
+                if (result.success) {
+                    if (result.reactComponents.length > 0) {
+                        this.reactComponents = result.reactComponents;
+                    }
+                    if (result.vueComponents.length > 0) {
+                        this.vueComponents = result.vueComponents;
+                    }
+                    console.log(`[DesignSystem] 동기화 완료: React ${this.reactComponents.length}개, Vue ${this.vueComponents.length}개` +
+                        (result.fromCache ? ' (캐시에서 로드)' : ' (GitHub에서 동기화)'));
+                }
+                else {
+                    console.warn('[DesignSystem] 동기화 실패, 하드코딩된 데이터 사용:', result.error);
+                }
+            }
+            catch (error) {
+                console.warn('[DesignSystem] 동기화 중 오류, 하드코딩된 데이터 사용:', error);
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * 수동 동기화 실행
+     */
+    async syncComponents(force = false) {
+        const result = await this.syncService.sync({
+            force,
+            verbose: this.syncConfig.verbose,
+        });
+        this.lastSyncResult = result;
+        if (result.success) {
+            if (result.reactComponents.length > 0) {
+                this.reactComponents = result.reactComponents;
+            }
+            if (result.vueComponents.length > 0) {
+                this.vueComponents = result.vueComponents;
+            }
+        }
+        return result;
+    }
+    /**
+     * 마지막 동기화 결과 조회
+     */
+    getLastSyncResult() {
+        return this.lastSyncResult;
+    }
+    /**
+     * 캐시 상태 조회
+     */
+    async getCacheStatus() {
+        return this.syncService.getCacheStatus();
+    }
+    /**
+     * 캐시 삭제
+     */
+    async clearCache() {
+        await this.syncService.clearCache();
+    }
     /**
      * 디자인 시스템(React, Vue) 컴포넌트 메타데이터 제공 필요.
      * 1. 메타데이터 구조 정의

package/dist/smithery.d.ts

@@ -2,49 +2,74 @@
  * Palette MCP Server - Smithery Remote 배포용
  *
  * Smithery.ai에서 호스팅될 때 사용됩니다.
- * Smithery가 이 파일을 로드하고 createServer 함수를 호출합니다.
+ * @smithery/sdk를 사용하여 HTTP 서버로 실행됩니다.
  */
 import { z } from 'zod';
-import { tools } from './server.js';
+/**
+ * Smithery 설정 스키마 정의
+ *
+ * Palette MCP Server Configuration
+ * Figma 디자인을 Design System 컴포넌트로 변환하기 위한 설정
+ *
+ * 모든 필드는 optional로 설정하여 Smithery Optional config 점수 획득
+ */
 export declare const configSchema: z.ZodObject<{
-    FIGMA_ACCESS_TOKEN: z.ZodString;
-    GITHUB_TOKEN: z.ZodString;
-    FIGMA_MCP_SERVER_URL: z.ZodDefault<z.ZodString>;
+    FIGMA_ACCESS_TOKEN: z.ZodOptional<z.ZodString>;
+    GITHUB_TOKEN: z.ZodOptional<z.ZodString>;
+    FIGMA_MCP_SERVER_URL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    FIGMA_ACCESS_TOKEN: string;
     FIGMA_MCP_SERVER_URL: string;
-    GITHUB_TOKEN: string;
+    FIGMA_ACCESS_TOKEN?: string | undefined;
+    GITHUB_TOKEN?: string | undefined;
 }, {
-    FIGMA_ACCESS_TOKEN: string;
-    GITHUB_TOKEN: string;
+    FIGMA_ACCESS_TOKEN?: string | undefined;
     FIGMA_MCP_SERVER_URL?: string | undefined;
+    GITHUB_TOKEN?: string | undefined;
 }>;
 type SmitheryConfig = z.infer<typeof configSchema>;
 /**
- * Smithery에서 호출하는 서버 생성 함수
- *
- * @param config - Smithery에서 전달받은 사용자 설정
- * @returns MCP 서버 인스턴스
+ * MCP 서버 생성 함수 - Smithery가 호출
  */
-export default function createServer({ config }: {
-    config: SmitheryConfig;
-}): import("@modelcontextprotocol/sdk/server/index.js").Server<{
+export default function createMcpServer({ config }?: {
+    config?: SmitheryConfig;
+}): import("@modelcontextprotocol/sdk/server").Server<{
     method: string;
-    params?: z.objectOutputType<{
-        _meta: z.ZodOptional<z.ZodObject<{
-            progressToken: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            progressToken: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            progressToken: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-        }, z.ZodTypeAny, "passthrough">>>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
+    params?: {
+        [x: string]: unknown;
+        task?: {
+            [x: string]: unknown;
+            ttl?: number | null | undefined;
+            pollInterval?: number | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
 }, {
     method: string;
-    params?: z.objectOutputType<{
-        _meta: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-}, z.objectOutputType<{
-    _meta: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
-}, z.ZodTypeAny, "passthrough">>;
-export { tools };
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        "io.modelcontextprotocol/related-task"?: {
+            [x: string]: unknown;
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+export {};

package/dist/smithery.js

@@ -2,43 +2,79 @@
  * Palette MCP Server - Smithery Remote 배포용
  *
  * Smithery.ai에서 호스팅될 때 사용됩니다.
- * Smithery가 이 파일을 로드하고 createServer 함수를 호출합니다.
+ * @smithery/sdk를 사용하여 HTTP 서버로 실행됩니다.
  */
+import { createStatelessServer } from '@smithery/sdk/server/stateless.js';
 import { z } from 'zod';
-import { createPaletteServer, tools } from './server.js';
-// Smithery 설정 스키마 정의
+import { createPaletteServer } from './server.js';
+/**
+ * Smithery 설정 스키마 정의
+ *
+ * Palette MCP Server Configuration
+ * Figma 디자인을 Design System 컴포넌트로 변환하기 위한 설정
+ *
+ * 모든 필드는 optional로 설정하여 Smithery Optional config 점수 획득
+ */
 export const configSchema = z.object({
+    // Figma Access Token - Figma API 호출에 필요
     FIGMA_ACCESS_TOKEN: z
         .string()
-        .describe('Figma Personal Access Token (https://www.figma.com/developers/api#access-tokens)'),
+        .min(1)
+        .optional()
+        .describe('Figma Personal Access Token. Required for accessing Figma designs. Get yours at https://www.figma.com/developers/api#access-tokens'),
+    // GitHub Token - 비공개 디자인 시스템 패키지 접근용
     GITHUB_TOKEN: z
         .string()
-        .describe('GitHub Personal Access Token for design system packages'),
+        .min(1)
+        .optional()
+        .describe('GitHub Personal Access Token for accessing private design system packages. Required only for private repositories.'),
+    // Figma MCP Server URL - 로컬 개발용 (Remote 모드에서는 사용 안함)
     FIGMA_MCP_SERVER_URL: z
         .string()
+        .url('Must be a valid URL')
+        .optional()
         .default('http://127.0.0.1:3845/mcp')
-        .describe('Figma Dev Mode MCP server URL'),
-});
+        .describe('Figma Dev Mode MCP server URL. Only needed for local development with Figma Desktop app.'),
+}).describe('Configuration options for Palette MCP Server - Figma to Design System converter');
+// 기본 설정
+const defaultConfig = {
+    FIGMA_ACCESS_TOKEN: undefined,
+    GITHUB_TOKEN: undefined,
+    FIGMA_MCP_SERVER_URL: 'http://127.0.0.1:3845/mcp',
+};
 /**
- * Smithery에서 호출하는 서버 생성 함수
- *
- * @param config - Smithery에서 전달받은 사용자 설정
- * @returns MCP 서버 인스턴스
+ * MCP 서버 생성 함수 - Smithery가 호출
  */
-export default function createServer({ config }) {
-    // 환경변수 설정
-    process.env.FIGMA_ACCESS_TOKEN = config.FIGMA_ACCESS_TOKEN;
-    process.env.GITHUB_TOKEN = config.GITHUB_TOKEN;
-    process.env.FIGMA_MCP_SERVER_URL = config.FIGMA_MCP_SERVER_URL;
+export default function createMcpServer({ config } = {}) {
+    // config가 없거나 불완전해도 서버 초기화 가능하도록 방어적 처리
+    const safeConfig = { ...defaultConfig, ...config };
+    // 환경변수 설정 (값이 있는 경우에만)
+    if (safeConfig.FIGMA_ACCESS_TOKEN) {
+        process.env.FIGMA_ACCESS_TOKEN = safeConfig.FIGMA_ACCESS_TOKEN;
+    }
+    if (safeConfig.GITHUB_TOKEN) {
+        process.env.GITHUB_TOKEN = safeConfig.GITHUB_TOKEN;
+    }
+    if (safeConfig.FIGMA_MCP_SERVER_URL) {
+        process.env.FIGMA_MCP_SERVER_URL = safeConfig.FIGMA_MCP_SERVER_URL;
+    }
     // 공통 서버 생성 로직 사용
+    // Remote 모드에서는 Figma Desktop MCP 클라이언트를 사용하지 않음 (로컬호스트 접근 불가)
     const server = createPaletteServer({
-        figmaAccessToken: config.FIGMA_ACCESS_TOKEN,
-        githubToken: config.GITHUB_TOKEN,
-        figmaMcpServerUrl: config.FIGMA_MCP_SERVER_URL,
+        figmaAccessToken: safeConfig.FIGMA_ACCESS_TOKEN,
+        githubToken: safeConfig.GITHUB_TOKEN,
+        figmaMcpServerUrl: safeConfig.FIGMA_MCP_SERVER_URL,
+        useFigmaMcp: false, // Remote 모드에서는 Figma REST API만 사용
     });
-    console.error('Palette server created for Smithery (Remote mode)');
-    // Smithery가 기대하는 형식으로 반환
+    console.error('Palette MCP server created for Smithery (Remote mode)');
     return server;
 }
-// Tools 정보도 export (Smithery가 capabilities 탐지에 사용할 수 있음)
-export { tools };
+// 직접 실행 시에만 서버 시작 (Smithery에서 import할 때는 실행 안됨)
+// Smithery는 createStatelessServer를 내부적으로 호출함
+if (process.env.SMITHERY_STANDALONE === 'true') {
+    const { app } = createStatelessServer(createMcpServer);
+    const port = process.env.PORT || 3000;
+    app.listen(port, () => {
+        console.error(`Palette MCP server listening on port ${port}`);
+    });
+}

package/dist/utils/request-manager.js

@@ -3,8 +3,17 @@ import { existsSync } from 'fs';
 import { join } from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+// ESM과 CJS 모두 호환되는 __dirname 구현
+let __dirname_resolved;
+try {
+    // ESM 환경
+    const __filename = fileURLToPath(import.meta.url);
+    __dirname_resolved = dirname(__filename);
+}
+catch {
+    // CJS 환경 또는 번들러 환경 - process.cwd() 사용
+    __dirname_resolved = process.cwd();
+}
 /**
  * 요청 ID 생성 (타임스탬프 + 랜덤 문자열)
  */
@@ -17,7 +26,7 @@ export function generateRequestId() {
  * 요청별 폴더 경로 생성
  */
 export function getRequestFolderPath(requestId) {
-    const projectRoot = join(__dirname, '..', '..');
+    const projectRoot = join(__dirname_resolved, '..', '..');
     return join(projectRoot, 'dist', 'requests', requestId);
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palette-mcp",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "MCP server for converting Figma designs to React/Vue components using design system",
   "main": "dist/index.js",
   "module": "src/smithery.ts",
@@ -35,6 +35,7 @@
     "test:services": "tsx src/test.ts",
     "test:figma-tools": "tsx src/test-figma-tools.ts",
     "test:mcp-servers": "tsx src/test-mcp-servers.ts",
+    "sync:ds": "tsx src/scripts/sync-design-system.ts",
     "mcp": "node dist/index.js",
     "mcp:dev": "tsx src/index.ts",
     "prepublishOnly": "npm run build"
@@ -69,10 +70,14 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.4.0",
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "@octokit/rest": "^21.0.0",
+    "@smithery/sdk": "^2.1.0",
     "axios": "^1.6.0",
+    "cors": "^2.8.5",
     "dotenv": "^17.2.3",
-    "puppeteer": "^21.0.0",
+    "express": "^5.2.1",
+    "typescript": "^5.0.0",
     "zod": "^3.22.0"
   },
   "peerDependencies": {
@@ -88,13 +93,15 @@
     }
   },
   "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
     "@types/jest": "^29.0.0",
     "@types/node": "^20.0.0",
+    "@types/puppeteer": "^7.0.4",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "jest": "^29.0.0",
-    "tsx": "^4.20.6",
-    "typescript": "^5.0.0"
+    "tsx": "^4.20.6"
   },
   "publishConfig": {
     "access": "public"

package/smithery.yaml

@@ -1,12 +1,5 @@
 # Smithery.ai MCP Server Configuration
 # https://smithery.ai/docs/build/config
-#
-# 이 서버는 두 가지 모드를 지원합니다:
-# - Remote: Smithery.ai에서 호스팅 (runtime: typescript)
-# - Local: npx palette-mcp로 직접 실행
 
-# TypeScript 런타임으로 Smithery 호스팅
-runtime: typescript
-
-# Smithery가 로드할 모듈 (src/smithery.ts)
-# package.json의 "module" 필드와 연동됨
+# TypeScript runtime: configSchema is defined in smithery.ts using zod
+runtime: "typescript"