vlossom-mcp 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# vlossom-mcp
+
+Vlossom UI 컴포넌트 라이브러리를 AI 어시스턴트(Claude 등)가 정확하게 참조할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.
+
+## 사전 요구사항
+
+| 도구        | 버전     |
+| ----------- | -------- |
+| Node.js     | 18.0 이상 |
+
+## 기술 스택
+
+- Node.js / TypeScript
+- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) — MCP SDK
+- stdio transport (인증 없음)
+
+## 제공 도구
+
+| 도구                  | 설명                                           |
+| --------------------- | ---------------------------------------------- |
+| `list_components`     | Vlossom 컴포넌트 전체 목록과 설명 반환         |
+| `check_github_token`  | GitHub 토큰 설정 여부 확인                     |
+| `draft_issue`         | bug / enhancement / question 이슈 초안 생성    |
+| `report_issue`        | vlossom-ui/vlossom 레포에 GitHub 이슈 등록     |
+
+## AI 어시스턴트 연결
+
+### Claude Code / Claude Desktop
+
+`claude.json` (또는 `claude_desktop_config.json`):
+
+```json
+{
+    "mcpServers": {
+        "vlossom": {
+            "command": "npx",
+            "args": ["-y", "@vlossom/mcp"],
+            "env": {
+                "VLOSSOM_GITHUB_TOKEN": "ghp_your_token_here"
+            }
+        }
+    }
+}
+```
+
+### 로컬 개발 빌드로 연결 (모노레포 내부)
+
+```json
+{
+    "mcpServers": {
+        "vlossom": {
+            "command": "node",
+            "args": ["packages/vlossom-mcp/dist/index.js"]
+        }
+    }
+}
+```
+
+## 환경변수
+
+| 변수                        | 필수 | 설명                                                    |
+| --------------------------- | ---- | ------------------------------------------------------- |
+| `VLOSSOM_GITHUB_TOKEN`      | 선택 | GitHub PAT (issues:write 권한). `report_issue` 사용 시 필요 |
+| `VLOSSOM_COMPONENTS_PATH`   | 선택 | 컴포넌트 디렉토리 절대경로. 미설정 시 모노레포 내 자동 탐색 |
+
+## 개발
+
+```bash
+cd packages/vlossom-mcp
+
+# 의존성 설치
+npm install
+
+# 빌드
+npm run build
+
+# 빌드 후 직접 실행
+node dist/index.js
+```
+
+## 상세 계획
+
+- [개요 및 설계 결정](../docs/plans/vlossom-mcp/OVERVIEW.md)
+- [기술 스펙](../docs/plans/vlossom-mcp/specs/2026-03-23-design.md)
+- [구현 계획](../docs/plans/vlossom-mcp/2026-03-23-implementation-plan.md)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    process.stderr.write(`Server failed to start: ${String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,wBAAgB,YAAY,IAAI,SAAS,CAUxC"}

package/dist/server.js

@@ -0,0 +1,19 @@
+import { createRequire } from "module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerListComponents } from "./tools/list-components.js";
+import { registerCheckGitHubToken } from "./tools/check-github-token.js";
+import { registerSetGitHubToken } from "./tools/set-github-token.js";
+import { registerDraftIssue } from "./tools/draft-issue.js";
+import { registerReportIssue } from "./tools/report-issue.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+export function createServer() {
+    const server = new McpServer({ name: "vlossom-mcp", version });
+    registerListComponents(server);
+    registerCheckGitHubToken(server);
+    registerSetGitHubToken(server);
+    registerDraftIssue(server);
+    registerReportIssue(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,UAAU,YAAY;IACxB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAE/D,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/services/component-registry.d.ts

@@ -0,0 +1,7 @@
+export interface ComponentInfo {
+    name: string;
+    kebabName: string;
+    description: string;
+}
+export declare function getComponents(): ComponentInfo[];
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/services/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/services/component-registry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,aAAa,IAAI,aAAa,EAAE,CAwB/C"}

package/dist/services/component-registry.js

@@ -0,0 +1,41 @@
+import { readdirSync, readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { resolveComponentsPath } from "../utils/path-resolver.js";
+let cache = null;
+export function getComponents() {
+    if (cache)
+        return cache;
+    const componentsPath = resolveComponentsPath();
+    if (!componentsPath) {
+        process.stderr.write("Warning: Components directory not found. Set VLOSSOM_COMPONENTS_PATH environment variable.\n");
+        return [];
+    }
+    cache = readdirSync(componentsPath, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && entry.name.startsWith("vs-"))
+        .map((entry) => {
+        const kebabName = entry.name;
+        return {
+            name: kebabToPascalCase(kebabName),
+            kebabName,
+            description: readDescription(join(componentsPath, kebabName)),
+        };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+    return cache;
+}
+function kebabToPascalCase(kebab) {
+    return kebab
+        .split("-")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+function readDescription(componentDir) {
+    const readmePath = join(componentDir, "README.md");
+    if (!existsSync(readmePath))
+        return "";
+    const lines = readFileSync(readmePath, "utf-8").split("\n");
+    return (lines
+        .map((l) => l.trim())
+        .find((l) => l.length > 0 && !l.startsWith(">") && !l.startsWith("#")) ?? "");
+}
+//# sourceMappingURL=component-registry.js.map

package/dist/services/component-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.js","sourceRoot":"","sources":["../../src/services/component-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAQlE,IAAI,KAAK,GAA2B,IAAI,CAAC;AAEzC,MAAM,UAAU,aAAa;IACzB,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,cAAc,GAAG,qBAAqB,EAAE,CAAC;IAC/C,IAAI,CAAC,cAAc,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,8FAA8F,CACjG,CAAC;QACF,OAAO,EAAE,CAAC;IACd,CAAC;IAED,KAAK,GAAG,WAAW,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACvD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;SACtE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACX,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,OAAO;YACH,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC;YAClC,SAAS;YACT,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;SAChE,CAAC;IACN,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAElD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACpC,OAAO,KAAK;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,YAAoB;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,CACH,KAAK;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CACnF,CAAC;AACN,CAAC"}

package/dist/services/github-client.d.ts

@@ -0,0 +1,8 @@
+export interface CreateIssueResult {
+    issueUrl: string;
+    issueNumber: number;
+}
+export declare function setGitHubToken(token: string): void;
+export declare function getGitHubToken(): string | undefined;
+export declare function createIssue(token: string, title: string, body: string, labels?: string[]): Promise<CreateIssueResult>;
+//# sourceMappingURL=github-client.d.ts.map

package/dist/services/github-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../../src/services/github-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAsB,WAAW,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAoB5B"}

package/dist/services/github-client.js

@@ -0,0 +1,28 @@
+const GITHUB_API_URL = "https://api.github.com/repos/vlossom-ui/vlossom/issues";
+let runtimeToken;
+export function setGitHubToken(token) {
+    runtimeToken = token;
+}
+export function getGitHubToken() {
+    return runtimeToken || process.env["VLOSSOM_GITHUB_TOKEN"] || undefined;
+}
+export async function createIssue(token, title, body, labels) {
+    const response = await fetch(GITHUB_API_URL, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "User-Agent": "vlossom-mcp",
+            Accept: "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ title, body, labels: labels ?? [] }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`GitHub API error ${response.status}: ${text}`);
+    }
+    const data = (await response.json());
+    return { issueUrl: data.html_url, issueNumber: data.number };
+}
+//# sourceMappingURL=github-client.js.map

package/dist/services/github-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.js","sourceRoot":"","sources":["../../src/services/github-client.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,wDAAwD,CAAC;AAOhF,IAAI,YAAgC,CAAC;AAErC,MAAM,UAAU,cAAc,CAAC,KAAa;IACxC,YAAY,GAAG,KAAK,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,cAAc;IAC1B,OAAO,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,SAAS,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,KAAa,EACb,KAAa,EACb,IAAY,EACZ,MAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;QACzC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,YAAY,EAAE,aAAa;YAC3B,MAAM,EAAE,6BAA6B;YACrC,sBAAsB,EAAE,YAAY;YACpC,cAAc,EAAE,kBAAkB;SACrC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;KAC9D,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyC,CAAC;IAC7E,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACjE,CAAC"}

package/dist/tools/check-github-token.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCheckGitHubToken(server: McpServer): void;
+//# sourceMappingURL=check-github-token.d.ts.map

package/dist/tools/check-github-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-github-token.d.ts","sourceRoot":"","sources":["../../src/tools/check-github-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAOhE"}

package/dist/tools/check-github-token.js

@@ -0,0 +1,6 @@
+import { getGitHubToken } from "../services/github-client.js";
+import { textResponse } from "../utils/mcp-response.js";
+export function registerCheckGitHubToken(server) {
+    server.tool("check_github_token", "Check whether a GitHub token is configured for submitting issues.", {}, () => textResponse({ isConfigured: !!getGitHubToken() }));
+}
+//# sourceMappingURL=check-github-token.js.map

package/dist/tools/check-github-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-github-token.js","sourceRoot":"","sources":["../../src/tools/check-github-token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACP,oBAAoB,EACpB,mEAAmE,EACnE,EAAE,EACF,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAC3D,CAAC;AACN,CAAC"}

package/dist/tools/draft-issue.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDraftIssue(server: McpServer): void;
+//# sourceMappingURL=draft-issue.d.ts.map

package/dist/tools/draft-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-issue.d.ts","sourceRoot":"","sources":["../../src/tools/draft-issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgB1D"}

package/dist/tools/draft-issue.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { textResponse } from "../utils/mcp-response.js";
+export function registerDraftIssue(server) {
+    server.tool("draft_issue", "Generate a structured Markdown template for a GitHub issue. " +
+        "ALWAYS call this before report_issue. " +
+        "After receiving the template, go through each requiredSection with the user one by one " +
+        "to collect detailed information before submitting.", {
+        summary: z.string().describe("Brief one-line summary of the issue"),
+        type: z
+            .enum(["bug", "enhancement", "question"])
+            .default("bug")
+            .describe("Issue type"),
+    }, ({ summary, type }) => textResponse(buildDraft(summary, type)));
+}
+function buildDraft(summary, type) {
+    switch (type) {
+        case "enhancement":
+            return {
+                suggestedTitle: `feat: ${summary}`,
+                bodyTemplate: `## 요청 기능\n\n${summary}\n\n` +
+                    `## 동기 / 사용 사례\n\n<!-- 이 기능이 왜 필요한지 설명해주세요 -->\n\n` +
+                    `## 제안하는 API / 동작\n\n\`\`\`vue\n<!-- 예상 사용 예시 -->\n\`\`\`\n\n` +
+                    `## 추가 컨텍스트\n\n<!-- 참고 자료, 스크린샷 등 -->`,
+                requiredSections: ["동기 / 사용 사례", "제안하는 API / 동작"],
+            };
+        case "question":
+            return {
+                suggestedTitle: `question: ${summary}`,
+                bodyTemplate: `## 질문\n\n${summary}\n\n` +
+                    `## 시도한 것\n\n<!-- 이미 시도해본 것들을 적어주세요 -->\n\n` +
+                    `## 관련 코드\n\n\`\`\`vue\n<!-- 관련 코드 -->\n\`\`\``,
+                requiredSections: ["시도한 것", "관련 코드"],
+            };
+        default:
+            return {
+                suggestedTitle: `fix: ${summary}`,
+                bodyTemplate: `## 버그 설명\n\n${summary}\n\n` +
+                    `## 재현 방법\n\n1. \n2. \n3. \n\n` +
+                    `## 예상 동작\n\n<!-- 어떻게 동작해야 하나요? -->\n\n` +
+                    `## 실제 동작\n\n<!-- 실제로는 어떻게 동작하나요? -->\n\n` +
+                    `## 코드 예시\n\n\`\`\`vue\n<!-- 재현 코드 -->\n\`\`\`\n\n` +
+                    `## 환경\n\n- Vlossom 버전: \n- Vue 버전: \n- 브라우저: `,
+                requiredSections: ["재현 방법", "예상 동작", "실제 동작", "코드 예시"],
+            };
+    }
+}
+//# sourceMappingURL=draft-issue.js.map

package/dist/tools/draft-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-issue.js","sourceRoot":"","sources":["../../src/tools/draft-issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACP,aAAa,EACb,8DAA8D;QAC1D,wCAAwC;QACxC,yFAAyF;QACzF,oDAAoD,EACxD;QACI,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACnE,IAAI,EAAE,CAAC;aACF,IAAI,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;aACxC,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,YAAY,CAAC;KAC9B,EACD,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CACjE,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CACf,OAAe,EACf,IAAwC;IAExC,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,aAAa;YACd,OAAO;gBACH,cAAc,EAAE,SAAS,OAAO,EAAE;gBAClC,YAAY,EACR,eAAe,OAAO,MAAM;oBAC5B,mDAAmD;oBACnD,8DAA8D;oBAC9D,sCAAsC;gBAC1C,gBAAgB,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;aACpD,CAAC;QACN,KAAK,UAAU;YACX,OAAO;gBACH,cAAc,EAAE,aAAa,OAAO,EAAE;gBACtC,YAAY,EACR,YAAY,OAAO,MAAM;oBACzB,4CAA4C;oBAC5C,+CAA+C;gBACnD,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;aACvC,CAAC;QACN;YACI,OAAO;gBACH,cAAc,EAAE,QAAQ,OAAO,EAAE;gBACjC,YAAY,EACR,eAAe,OAAO,MAAM;oBAC5B,+BAA+B;oBAC/B,wCAAwC;oBACxC,0CAA0C;oBAC1C,mDAAmD;oBACnD,+CAA+C;gBACnD,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;aACzD,CAAC;IACV,CAAC;AACL,CAAC"}

package/dist/tools/list-components.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListComponents(server: McpServer): void;
+//# sourceMappingURL=list-components.d.ts.map

package/dist/tools/list-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.d.ts","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAO9D"}

package/dist/tools/list-components.js

@@ -0,0 +1,6 @@
+import { getComponents } from "../services/component-registry.js";
+import { textResponse } from "../utils/mcp-response.js";
+export function registerListComponents(server) {
+    server.tool("list_components", "Get a list of all Vlossom UI components with their names and descriptions.", {}, () => textResponse(getComponents()));
+}
+//# sourceMappingURL=list-components.js.map

package/dist/tools/list-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.js","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACP,iBAAiB,EACjB,4EAA4E,EAC5E,EAAE,EACF,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CACtC,CAAC;AACN,CAAC"}

package/dist/tools/report-issue.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerReportIssue(server: McpServer): void;
+//# sourceMappingURL=report-issue.d.ts.map

package/dist/tools/report-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-issue.d.ts","sourceRoot":"","sources":["../../src/tools/report-issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0B3D"}

package/dist/tools/report-issue.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { createIssue, getGitHubToken } from "../services/github-client.js";
+import { textResponse } from "../utils/mcp-response.js";
+export function registerReportIssue(server) {
+    server.tool("report_issue", "Create a GitHub issue on the Vlossom repository. " +
+        "Call draft_issue first and fill in all requiredSections with the user before calling this. " +
+        "Always confirm the final content with the user before submitting. " +
+        "Requires VLOSSOM_GITHUB_TOKEN environment variable with issues:write scope.", {
+        title: z.string().describe("Issue title"),
+        body: z.string().describe("Issue body in Markdown, with all sections filled in"),
+        labels: z
+            .array(z.string())
+            .optional()
+            .describe("Optional labels such as 'bug', 'enhancement', 'question'"),
+    }, async ({ title, body, labels }) => {
+        const token = getGitHubToken();
+        if (!token) {
+            throw new Error("VLOSSOM_GITHUB_TOKEN is not configured. " +
+                "Set the environment variable with a GitHub PAT that has issues:write scope.");
+        }
+        return textResponse(await createIssue(token, title, body, labels));
+    });
+}
+//# sourceMappingURL=report-issue.js.map

package/dist/tools/report-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-issue.js","sourceRoot":"","sources":["../../src/tools/report-issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACjD,MAAM,CAAC,IAAI,CACP,cAAc,EACd,mDAAmD;QAC/C,6FAA6F;QAC7F,oEAAoE;QACpE,6EAA6E,EACjF;QACI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;QAChF,MAAM,EAAE,CAAC;aACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;KAC5E,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACX,0CAA0C;gBACtC,6EAA6E,CACpF,CAAC;QACN,CAAC;QACD,OAAO,YAAY,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/set-github-token.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSetGitHubToken(server: McpServer): void;
+//# sourceMappingURL=set-github-token.d.ts.map

package/dist/tools/set-github-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-github-token.d.ts","sourceRoot":"","sources":["../../src/tools/set-github-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkB9D"}

package/dist/tools/set-github-token.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { setGitHubToken } from "../services/github-client.js";
+import { textResponse } from "../utils/mcp-response.js";
+export function registerSetGitHubToken(server) {
+    server.tool("set_github_token", "Store a GitHub Personal Access Token (PAT) for this session so that report_issue can submit issues. " +
+        "Call this when check_github_token returns isConfigured: false. " +
+        "Ask the user to provide a PAT with issues:write scope, then pass it here. " +
+        "The token is kept in memory only and is not persisted to disk.", {
+        token: z
+            .string()
+            .min(1)
+            .describe("GitHub Personal Access Token with issues:write scope (e.g. ghp_xxxx or github_pat_xxxx)"),
+    }, ({ token }) => {
+        setGitHubToken(token);
+        return textResponse({ success: true, message: "GitHub token has been set for this session." });
+    });
+}
+//# sourceMappingURL=set-github-token.js.map

package/dist/tools/set-github-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-github-token.js","sourceRoot":"","sources":["../../src/tools/set-github-token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACP,kBAAkB,EAClB,sGAAsG;QAClG,iEAAiE;QACjE,4EAA4E;QAC5E,gEAAgE,EACpE;QACI,KAAK,EAAE,CAAC;aACH,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,yFAAyF,CAAC;KAC3G,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACV,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC,CAAC;IACnG,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/utils/mcp-response.d.ts

@@ -0,0 +1,7 @@
+export declare function textResponse(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=mcp-response.d.ts.map

package/dist/utils/mcp-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-response.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-response.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO;;;;;EAIzC"}

package/dist/utils/mcp-response.js

@@ -0,0 +1,6 @@
+export function textResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data) }],
+    };
+}
+//# sourceMappingURL=mcp-response.js.map

package/dist/utils/mcp-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-response.js","sourceRoot":"","sources":["../../src/utils/mcp-response.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAa;IACtC,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;KACnE,CAAC;AACN,CAAC"}

package/dist/utils/path-resolver.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveComponentsPath(): string | null;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/utils/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/path-resolver.ts"],"names":[],"mappings":"AAMA,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAmBrD"}

package/dist/utils/path-resolver.js

@@ -0,0 +1,22 @@
+import { existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export function resolveComponentsPath() {
+    const envPath = process.env["VLOSSOM_COMPONENTS_PATH"];
+    if (envPath) {
+        return resolve(envPath);
+    }
+    // 모노레포 내 개발 환경: packages/vlossom-mcp/dist/utils/ -> packages/vlossom/src/components
+    const monorepoPaths = [
+        resolve(__dirname, "../../../vlossom/src/components"),
+        resolve(__dirname, "../../../../packages/vlossom/src/components"),
+    ];
+    for (const candidate of monorepoPaths) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/utils/path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.js","sourceRoot":"","sources":["../../src/utils/path-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,UAAU,qBAAqB;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,oFAAoF;IACpF,MAAM,aAAa,GAAG;QAClB,OAAO,CAAC,SAAS,EAAE,iCAAiC,CAAC;QACrD,OAAO,CAAC,SAAS,EAAE,6CAA6C,CAAC;KACpE,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACpC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "vlossom-mcp",
+    "version": "0.1.0",
+    "description": "MCP server for Vlossom UI component library",
+    "type": "module",
+    "bin": {
+        "vlossom-mcp": "./dist/index.js"
+    },
+    "main": "./dist/index.js",
+    "scripts": {
+        "build": "tsc && node -e \"const fs=require('fs');const f='dist/index.js';fs.writeFileSync(f,'#!/usr/bin/env node\\n'+fs.readFileSync(f,'utf8'));\"",
+        "dev": "tsc --watch",
+        "start": "node dist/index.js",
+        "prepublishOnly": "npm run build"
+    },
+    "files": [
+        "dist"
+    ],
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "zod": "^3.24.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "typescript": "~5.8.3"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vlossom-ui/vlossom.git",
+        "directory": "packages/vlossom-mcp"
+    },
+    "license": "MIT",
+    "keywords": [
+        "mcp",
+        "vlossom",
+        "vue",
+        "ui-components",
+        "claude"
+    ]
+}