@thinkdata/mcp-server 0.2.0 → 0.3.0

package/dist/index.js

@@ -7397,10 +7397,6 @@ var init_src = __esm({
   }
 });
 
-// src/index.ts
-import { readFileSync, existsSync } from "node:fs";
-import { resolve } from "node:path";
-
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -18899,13 +18895,13 @@ var zodToJsonSchema = (schema, options) => {
     }, true) ?? parseAnyDef(refs)
   }), {}) : void 0;
   const name = typeof options === "string" ? options : options?.nameStrategy === "title" ? void 0 : options?.name;
-  const main2 = parseDef(schema._def, name === void 0 ? refs : {
+  const main = parseDef(schema._def, name === void 0 ? refs : {
     ...refs,
     currentPath: [...refs.basePath, refs.definitionPath, name]
   }, false) ?? parseAnyDef(refs);
   const title = typeof options === "object" && options.name !== void 0 && options.nameStrategy === "title" ? options.name : void 0;
   if (title !== void 0) {
-    main2.title = title;
+    main.title = title;
   }
   if (refs.flags.hasReferencedOpenAiAnyType) {
     if (!definitions) {
@@ -18926,9 +18922,9 @@ var zodToJsonSchema = (schema, options) => {
     }
   }
   const combined = name === void 0 ? definitions ? {
-    ...main2,
+    ...main,
     [refs.definitionPath]: definitions
-  } : main2 : {
+  } : main : {
     $ref: [
       ...refs.$refStrategy === "relative" ? [] : refs.basePath,
       refs.definitionPath,
@@ -18936,7 +18932,7 @@ var zodToJsonSchema = (schema, options) => {
     ].join("/"),
     [refs.definitionPath]: {
       ...definitions,
-      [name]: main2
+      [name]: main
     }
   };
   if (refs.target === "jsonSchema7") {
@@ -21613,957 +21609,824 @@ var StdioServerTransport = class {
   }
 };
 
-// src/resources.ts
+// ../cli/dist/commands/mcp.js
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+
+// ../cli/dist/mcp/client.js
+var ThinkERDClient = class {
+  baseUrl;
+  headers;
+  constructor(apiUrl, token) {
+    this.baseUrl = apiUrl.replace(/\/+$/, "");
+    this.headers = {
+      "Authorization": `Bearer ${token}`,
+      "Content-Type": "application/json"
+    };
+  }
+  async request(path) {
+    const url = `${this.baseUrl}${path}`;
+    const res = await fetch(url, { headers: this.headers });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`ThinkERD API error ${res.status}: ${body || res.statusText}`);
+    }
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.includes("text/plain")) {
+      return res.text();
+    }
+    return res.json();
+  }
+  // ─── Diagrams ───
+  /** 사용자의 모든 다이어그램 목록 조회 */
+  async listDiagrams() {
+    return this.request("/api/mcp/diagrams");
+  }
+  /** 다이어그램 상세 (엔터티 + 관계 포함) */
+  async getDiagram(diagramId) {
+    return this.request(`/api/mcp/diagrams/${diagramId}`);
+  }
+  // ─── Entities ───
+  /** 단일 엔터티 상세 조회 */
+  async getEntity(diagramId, entityId) {
+    return this.request(`/api/mcp/diagrams/${diagramId}/entities/${entityId}`);
+  }
+  /** 엔터티 이름으로 검색 */
+  async searchEntities(diagramId, query) {
+    return this.request(`/api/mcp/diagrams/${diagramId}/entities?q=${encodeURIComponent(query)}`);
+  }
+  // ─── DDL ───
+  /** 다이어그램의 DDL 생성 */
+  async generateDDL(diagramId, dialect) {
+    const d = dialect ? `?dialect=${encodeURIComponent(dialect)}` : "";
+    return this.request(`/api/mcp/diagrams/${diagramId}/ddl${d}`);
+  }
+  // ─── Dictionary ───
+  /** 표준 사전 단어 목록 */
+  async getDictionary(projectId) {
+    return this.request(`/api/mcp/projects/${projectId}/dictionary`);
+  }
+  // ─── Drafts ───
+  /** 스키마 변경 제안 (Draft 생성) */
+  async proposeSchemaChange(diagramId, data) {
+    return this.postRequest(`/api/mcp/diagrams/${diagramId}/drafts`, data);
+  }
+  // ─── Sync / Push ───
+  async postRequest(path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`ThinkERD API error ${res.status}: ${text || res.statusText}`);
+    }
+    return res.json();
+  }
+  // ─── Context Provider (Project-level Ontology) ───
+  /** 자연어 질문 → 관련 엔터티 컨텍스트 (Graph RAG) */
+  async getProjectContext(projectId, question) {
+    return this.postRequest(`/api/mcp/projects/${projectId}/context`, { question });
+  }
+  /** 두 엔터티 간 JOIN 경로 탐색 */
+  async findJoinPath(projectId, from, to) {
+    return this.postRequest(`/api/mcp/projects/${projectId}/join-path`, { from, to });
+  }
+  /** 프로젝트 전체 스키마 요약 */
+  async getProjectSummary(projectId) {
+    return this.request(`/api/mcp/projects/${projectId}/summary`);
+  }
+  /** 메타데이터 풍부도 품질 보고 */
+  async checkMetadataQuality(projectId) {
+    return this.request(`/api/mcp/projects/${projectId}/quality`);
+  }
+  /** SPARQL 직접 실행 */
+  async queryOntology(projectId, query) {
+    return this.postRequest(`/api/ai/ontology/${projectId}/sparql`, { query });
+  }
+};
+
+// ../cli/dist/mcp/resources.js
 function registerResources(server, client) {
-  server.resource(
-    "diagrams",
-    "thinkerd://diagrams",
-    {
-      description: "ThinkERD \uD504\uB85C\uC81D\uD2B8\uC758 \uBAA8\uB4E0 \uB2E4\uC774\uC5B4\uADF8\uB7A8 \uBAA9\uB85D\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async () => {
-      const diagrams = await client.listDiagrams();
+  server.resource("diagrams", "thinkerd://diagrams", {
+    description: "ThinkERD \uD504\uB85C\uC81D\uD2B8\uC758 \uBAA8\uB4E0 \uB2E4\uC774\uC5B4\uADF8\uB7A8 \uBAA9\uB85D\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async () => {
+    const diagrams = await client.listDiagrams();
+    return {
+      contents: [{
+        uri: "thinkerd://diagrams",
+        mimeType: "application/json",
+        text: JSON.stringify(diagrams, null, 2)
+      }]
+    };
+  });
+  server.resource("diagram-schema", "thinkerd://diagrams/{diagramId}/schema", {
+    description: "\uD2B9\uC815 \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uC804\uCCB4 \uC2A4\uD0A4\uB9C8(\uC5D4\uD130\uD2F0, \uCEEC\uB7FC, \uAD00\uACC4)\uB97C JSON\uC73C\uB85C \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async (uri) => {
+    const diagramId = extractParam(uri.href, "diagrams");
+    const data = await client.getDiagram(diagramId);
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(data, null, 2)
+      }]
+    };
+  });
+  server.resource("entity-detail", "thinkerd://diagrams/{diagramId}/entities/{entityId}", {
+    description: "\uD2B9\uC815 \uC5D4\uD130\uD2F0\uC758 \uB17C\uB9AC\uBA85, \uBB3C\uB9AC\uBA85, \uCEEC\uB7FC \uC0C1\uC138(\uD0C0\uC785, PK/FK, Nullable \uB4F1)\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async (uri) => {
+    const parts = uri.href.split("/");
+    const entitiesIdx = parts.indexOf("entities");
+    const diagramsIdx = parts.indexOf("diagrams");
+    const diagramId = parts[diagramsIdx + 1];
+    const entityId = parts[entitiesIdx + 1];
+    const entity = await client.getEntity(diagramId, entityId);
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(entity, null, 2)
+      }]
+    };
+  });
+  server.resource("diagram-ddl", "thinkerd://diagrams/{diagramId}/ddl", {
+    description: "\uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 DDL(CREATE TABLE \uAD6C\uBB38)\uC744 \uC0DD\uC131\uD558\uC5EC \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async (uri) => {
+    const diagramId = extractParam(uri.href, "diagrams");
+    const ddl = await client.generateDDL(diagramId);
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "text/plain",
+        text: typeof ddl === "string" ? ddl : JSON.stringify(ddl)
+      }]
+    };
+  });
+  server.resource("dictionary", "thinkerd://projects/{projectId}/dictionary", {
+    description: "\uD504\uB85C\uC81D\uD2B8\uC758 \uD45C\uC900 \uC0AC\uC804(\uB2E8\uC5B4, \uB3C4\uBA54\uC778, \uAE08\uCE59\uC5B4)\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async (uri) => {
+    const projectId = extractParam(uri.href, "projects");
+    const words = await client.getDictionary(projectId);
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(words, null, 2)
+      }]
+    };
+  });
+  server.resource("project-summary", "thinkerd://projects/{projectId}/summary", {
+    description: "\uD504\uB85C\uC81D\uD2B8 \uC804\uCCB4 \uB370\uC774\uD130 \uBAA8\uB378\uC758 \uC694\uC57D(\uC5D4\uD130\uD2F0 \uC218, \uAD00\uACC4 \uC218, \uC8FC\uC81C\uC601\uC5ED \uAD6C\uC131, RDF \uD2B8\uB9AC\uD50C \uC218)\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async (uri) => {
+    const projectId = extractParam(uri.href, "projects");
+    const summary = await client.getProjectSummary(projectId);
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(summary, null, 2)
+      }]
+    };
+  });
+  server.resource("metadata-quality", "thinkerd://projects/{projectId}/quality", {
+    description: "\uD504\uB85C\uC81D\uD2B8\uC758 \uBA54\uD0C0\uB370\uC774\uD130 \uD48D\uBD80\uB3C4(\uC124\uBA85, \uB3D9\uC758\uC5B4, \uC18D\uC131 \uC785\uB825\uB960)\uB97C \uBD84\uC11D\uD55C \uD488\uC9C8 \uBCF4\uACE0\uC11C\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4."
+  }, async (uri) => {
+    const projectId = extractParam(uri.href, "projects");
+    const report = await client.checkMetadataQuality(projectId);
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(report, null, 2)
+      }]
+    };
+  });
+}
+function extractParam(href, segment) {
+  const parts = href.split("/");
+  const idx = parts.indexOf(segment);
+  if (idx === -1 || idx + 1 >= parts.length) {
+    throw new Error(`Invalid URI: cannot extract '${segment}' parameter from ${href}`);
+  }
+  return parts[idx + 1];
+}
+
+// ../cli/dist/mcp/tools.js
+function registerTools(server, client) {
+  server.tool("get_entity", "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0\uC11C \uD2B9\uC815 \uC5D4\uD130\uD2F0\uC758 \uCEEC\uB7FC, \uD0C0\uC785, PK/FK \uC815\uBCF4\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    entityId: external_exports.string().describe("\uC5D4\uD130\uD2F0 ID")
+  }, async ({ diagramId, entityId }) => {
+    try {
+      const entity = await client.getEntity(diagramId, entityId);
       return {
-        contents: [{
-          uri: "thinkerd://diagrams",
-          mimeType: "application/json",
-          text: JSON.stringify(diagrams, null, 2)
+        content: [{
+          type: "text",
+          text: JSON.stringify(entity, null, 2)
         }]
       };
-    }
-  );
-  server.resource(
-    "diagram-schema",
-    "thinkerd://diagrams/{diagramId}/schema",
-    {
-      description: "\uD2B9\uC815 \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uC804\uCCB4 \uC2A4\uD0A4\uB9C8(\uC5D4\uD130\uD2F0, \uCEEC\uB7FC, \uAD00\uACC4)\uB97C JSON\uC73C\uB85C \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async (uri) => {
-      const diagramId = extractParam(uri.href, "diagrams");
-      const data = await client.getDiagram(diagramId);
+    } catch (err) {
       return {
-        contents: [{
-          uri: uri.href,
-          mimeType: "application/json",
-          text: JSON.stringify(data, null, 2)
-        }]
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
       };
     }
-  );
-  server.resource(
-    "entity-detail",
-    "thinkerd://diagrams/{diagramId}/entities/{entityId}",
-    {
-      description: "\uD2B9\uC815 \uC5D4\uD130\uD2F0\uC758 \uB17C\uB9AC\uBA85, \uBB3C\uB9AC\uBA85, \uCEEC\uB7FC \uC0C1\uC138(\uD0C0\uC785, PK/FK, Nullable \uB4F1)\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async (uri) => {
-      const parts = uri.href.split("/");
-      const entitiesIdx = parts.indexOf("entities");
-      const diagramsIdx = parts.indexOf("diagrams");
-      const diagramId = parts[diagramsIdx + 1];
-      const entityId = parts[entitiesIdx + 1];
-      const entity = await client.getEntity(diagramId, entityId);
+  });
+  server.tool("search_entities", "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0\uC11C \uC774\uB984\uC73C\uB85C \uC5D4\uD130\uD2F0\uB97C \uAC80\uC0C9\uD569\uB2C8\uB2E4. \uB17C\uB9AC\uBA85/\uBB3C\uB9AC\uBA85 \uBAA8\uB450 \uAC80\uC0C9 \uAC00\uB2A5\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    query: external_exports.string().describe("\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC (\uC5D4\uD130\uD2F0 \uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)")
+  }, async ({ diagramId, query }) => {
+    try {
+      const entities = await client.searchEntities(diagramId, query);
+      const summary = entities.map((e) => ({
+        id: e.id,
+        name: e.name,
+        tableName: e.tableName,
+        role: e.entityRole,
+        columnCount: e.columns.length,
+        columns: e.columns.map((c) => `${c.name} (${c.type})${c.isPrimaryKey ? " [PK]" : ""}${c.isForeignKey ? " [FK]" : ""}`)
+      }));
       return {
-        contents: [{
-          uri: uri.href,
-          mimeType: "application/json",
-          text: JSON.stringify(entity, null, 2)
+        content: [{
+          type: "text",
+          text: JSON.stringify(summary, null, 2)
         }]
       };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.resource(
-    "diagram-ddl",
-    "thinkerd://diagrams/{diagramId}/ddl",
-    {
-      description: "\uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 DDL(CREATE TABLE \uAD6C\uBB38)\uC744 \uC0DD\uC131\uD558\uC5EC \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async (uri) => {
-      const diagramId = extractParam(uri.href, "diagrams");
-      const ddl = await client.generateDDL(diagramId);
+  });
+  server.tool("generate_ddl", "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 DDL(CREATE TABLE \uAD6C\uBB38)\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4. PostgreSQL, MySQL, Oracle \uB4F1 \uB2E4\uC591\uD55C \uBC29\uC5B8\uC744 \uC9C0\uC6D0\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    dialect: external_exports.enum(["postgresql", "mysql", "oracle", "mssql", "sqlite"]).optional().default("postgresql").describe("SQL \uBC29\uC5B8 (\uAE30\uBCF8\uAC12: postgresql)")
+  }, async ({ diagramId, dialect }) => {
+    try {
+      const ddl = await client.generateDDL(diagramId, dialect);
       return {
-        contents: [{
-          uri: uri.href,
-          mimeType: "text/plain",
+        content: [{
+          type: "text",
           text: typeof ddl === "string" ? ddl : JSON.stringify(ddl)
         }]
       };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.resource(
-    "dictionary",
-    "thinkerd://projects/{projectId}/dictionary",
-    {
-      description: "\uD504\uB85C\uC81D\uD2B8\uC758 \uD45C\uC900 \uC0AC\uC804(\uB2E8\uC5B4, \uB3C4\uBA54\uC778, \uAE08\uCE59\uC5B4)\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async (uri) => {
-      const projectId = extractParam(uri.href, "projects");
-      const words = await client.getDictionary(projectId);
+  });
+  server.tool("validate_schema", "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uC2A4\uD0A4\uB9C8\uB97C \uAC80\uC99D\uD569\uB2C8\uB2E4. \uB204\uB77D\uB41C PK, \uBBF8\uC5F0\uACB0 FK, \uBE44\uD45C\uC900 \uB124\uC774\uBC0D \uB4F1\uC744 \uC810\uAC80\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID")
+  }, async ({ diagramId }) => {
+    try {
+      const data = await client.getDiagram(diagramId);
+      const issues = [];
+      for (const entity of data.entities) {
+        const hasPK = entity.columns.some((c) => c.isPrimaryKey);
+        if (!hasPK) {
+          issues.push(`\u26A0\uFE0F [${entity.name}] PK(Primary Key)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.`);
+        }
+      }
+      for (const entity of data.entities) {
+        if (entity.columns.length === 0) {
+          issues.push(`\u26A0\uFE0F [${entity.name}] \uCEEC\uB7FC\uC774 \uD558\uB098\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4.`);
+        }
+      }
+      const connectedIds = /* @__PURE__ */ new Set();
+      for (const rel of data.relationships) {
+        connectedIds.add(rel.sourceEntityId);
+        connectedIds.add(rel.targetEntityId);
+      }
+      for (const entity of data.entities) {
+        if (!connectedIds.has(entity.id) && data.entities.length > 1) {
+          issues.push(`\u2139\uFE0F [${entity.name}] \uB2E4\uB978 \uC5D4\uD130\uD2F0\uC640 \uAD00\uACC4\uAC00 \uC5C6\uB294 \uACE0\uB9BD \uC5D4\uD130\uD2F0\uC785\uB2C8\uB2E4.`);
+        }
+      }
+      const summary = issues.length === 0 ? `\u2705 \uC2A4\uD0A4\uB9C8 \uAC80\uC99D \uC644\uB8CC: ${data.entities.length}\uAC1C \uC5D4\uD130\uD2F0, \uBB38\uC81C \uC5C6\uC74C.` : `\u{1F50D} \uC2A4\uD0A4\uB9C8 \uAC80\uC99D \uC644\uB8CC: ${data.entities.length}\uAC1C \uC5D4\uD130\uD2F0, ${issues.length}\uAC1C \uC774\uC288 \uBC1C\uACAC.
+
+${issues.join("\n")}`;
       return {
-        contents: [{
-          uri: uri.href,
-          mimeType: "application/json",
-          text: JSON.stringify(words, null, 2)
+        content: [{
+          type: "text",
+          text: summary
         }]
       };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.resource(
-    "project-summary",
-    "thinkerd://projects/{projectId}/summary",
-    {
-      description: "\uD504\uB85C\uC81D\uD2B8 \uC804\uCCB4 \uB370\uC774\uD130 \uBAA8\uB378\uC758 \uC694\uC57D(\uC5D4\uD130\uD2F0 \uC218, \uAD00\uACC4 \uC218, \uC8FC\uC81C\uC601\uC5ED \uAD6C\uC131, RDF \uD2B8\uB9AC\uD50C \uC218)\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async (uri) => {
-      const projectId = extractParam(uri.href, "projects");
-      const summary = await client.getProjectSummary(projectId);
+  });
+  server.tool("harvest_schema_semantics", "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uBB3C\uB9AC \uD14C\uC774\uBE14 \uBAA9\uB85D\uC744 \uAE30\uBC18\uC73C\uB85C \uC5ED\uACF5\uD559 \uCD94\uB860\uC744 \uC2E4\uD589\uD558\uC5EC \uB17C\uB9AC\uBA85, \uC124\uBA85, \uAD00\uACC4 \uB4F1\uC758 \uC2DC\uBA58\uD2F1 \uBA54\uD0C0\uB370\uC774\uD130\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    tableNames: external_exports.array(external_exports.string()).optional().describe("\uCD94\uCD9C\uD560 \uBB3C\uB9AC \uD14C\uC774\uBE14\uBA85 \uBAA9\uB85D. \uC0DD\uB7B5 \uC2DC \uC804\uCCB4 \uB2E4\uC774\uC5B4\uADF8\uB7A8 \uB300\uC0C1")
+  }, async ({ diagramId, tableNames }) => {
+    try {
+      const data = await client.getDiagram(diagramId);
+      let entities = data.entities;
+      if (tableNames && tableNames.length > 0) {
+        const tableSet = new Set(tableNames.map((t) => t.toUpperCase()));
+        entities = entities.filter((e) => e.tableName && tableSet.has(e.tableName.toUpperCase()));
+      }
+      const { extractFrequentTokens: extractFrequentTokens2 } = await Promise.resolve().then(() => (init_src(), src_exports));
+      const harvested = extractFrequentTokens2(entities, [], 1);
+      const summary = {
+        extractedSemantics: harvested,
+        relationships: data.relationships.filter((r) => entities.some((e) => e.id === r.sourceEntityId) || entities.some((e) => e.id === r.targetEntityId))
+      };
       return {
-        contents: [{
-          uri: uri.href,
-          mimeType: "application/json",
+        content: [{
+          type: "text",
           text: JSON.stringify(summary, null, 2)
         }]
       };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.resource(
-    "metadata-quality",
-    "thinkerd://projects/{projectId}/quality",
-    {
-      description: "\uD504\uB85C\uC81D\uD2B8\uC758 \uBA54\uD0C0\uB370\uC774\uD130 \uD48D\uBD80\uB3C4(\uC124\uBA85, \uB3D9\uC758\uC5B4, \uC18D\uC131 \uC785\uB825\uB960)\uB97C \uBD84\uC11D\uD55C \uD488\uC9C8 \uBCF4\uACE0\uC11C\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4."
-    },
-    async (uri) => {
-      const projectId = extractParam(uri.href, "projects");
-      const report = await client.checkMetadataQuality(projectId);
+  });
+  server.tool("propose_schema_change", "\uC678\uBD80 AI\uAC00 ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0 \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD\uC744 \uC81C\uC548\uD569\uB2C8\uB2E4. \uC0AC\uC6A9\uC790 \uC2B9\uC778\uC774 \uD544\uC694\uD55C Draft\uB85C \uC804\uC1A1\uB429\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB300\uC0C1 \uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    entityName: external_exports.string().describe("\uBCC0\uACBD \uB300\uC0C1 \uC5D4\uD130\uD2F0\uBA85 (\uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)"),
+    changeType: external_exports.enum(["add_column", "modify_column", "add_entity"]).describe("\uBCC0\uACBD \uC720\uD615"),
+    changeData: external_exports.record(external_exports.unknown()).describe("\uBCC0\uACBD \uB370\uC774\uD130 (JSON). add_column: {name, type, logicalName}, add_entity: {name, tableName, columns}"),
+    reason: external_exports.string().describe("\uBCC0\uACBD \uC0AC\uC720")
+  }, async ({ diagramId, entityName, changeType, changeData, reason }) => {
+    try {
+      const draft = await client.proposeSchemaChange(diagramId, {
+        entityName,
+        changeType,
+        changeData,
+        reason
+      });
       return {
-        contents: [{
-          uri: uri.href,
-          mimeType: "application/json",
-          text: JSON.stringify(report, null, 2)
+        content: [{
+          type: "text",
+          text: `\u2705 \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD \uC81C\uC548\uC774 ThinkERD\uC5D0 \uC804\uC1A1\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
+
+Draft ID: ${draft.draft_id}
+\uC0C1\uD0DC: ${draft.status}
+\uB300\uC0C1: ${entityName}
+\uC720\uD615: ${changeType}
+\uC0AC\uC720: ${reason}
+
+\u26A0\uFE0F ThinkERD\uC5D0\uC11C \uC0AC\uC6A9\uC790\uAC00 \uC774 \uC81C\uC548\uC744 \uC2B9\uC778\uD574\uC57C \uC801\uC6A9\uB429\uB2C8\uB2E4.`
         }]
       };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-}
-function extractParam(href, segment) {
-  const parts = href.split("/");
-  const idx = parts.indexOf(segment);
-  if (idx === -1 || idx + 1 >= parts.length) {
-    throw new Error(`Invalid URI: cannot extract '${segment}' parameter from ${href}`);
-  }
-  return parts[idx + 1];
-}
-
-// src/tools.ts
-function registerTools(server, client) {
-  server.tool(
-    "get_entity",
-    "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0\uC11C \uD2B9\uC815 \uC5D4\uD130\uD2F0\uC758 \uCEEC\uB7FC, \uD0C0\uC785, PK/FK \uC815\uBCF4\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      entityId: external_exports.string().describe("\uC5D4\uD130\uD2F0 ID")
-    },
-    async ({ diagramId, entityId }) => {
-      try {
-        const entity = await client.getEntity(diagramId, entityId);
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(entity, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
+  });
+  server.tool("get_business_dictionary", "\uC0AC\uB0B4 \uD45C\uC900 \uB2E8\uC5B4/\uC6A9\uC5B4 \uC0AC\uC804\uC5D0\uC11C \uD0A4\uC6CC\uB4DC\uB97C \uAC80\uC0C9\uD558\uC5EC \uB17C\uB9AC\uBA85-\uBB3C\uB9AC\uBA85 \uB9E4\uD551 \uAC00\uC774\uB4DC\uB97C \uC81C\uACF5\uD569\uB2C8\uB2E4. \uAC01 \uB2E8\uC5B4\uC758 \uB3D9\uC758\uC5B4(synonyms)\uB3C4 \uD568\uAED8 \uBC18\uD658\uD558\uBBC0\uB85C, \uC0AC\uC6A9\uC790\uAC00 \uC4F4 \uB9D0\uC774 \uC0AC\uB0B4\uC5D0\uC11C \uC5B4\uB5A4 \uD45C\uC900 \uB2E8\uC5B4\uC778\uC9C0 \uB418\uC9DA\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4.", {
+    projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
+    keyword: external_exports.string().optional().describe("\uAC80\uC0C9\uC5B4 (\uC0DD\uB7B5 \uC2DC \uC804\uCCB4 \uC870\uD68C). \uB3D9\uC758\uC5B4\uB85C\uB3C4 \uAC80\uC0C9\uB429\uB2C8\uB2E4")
+  }, async ({ projectId, keyword }) => {
+    try {
+      let dictionary = await client.getDictionary(projectId);
+      if (keyword) {
+        const lowerKeyword = keyword.toLowerCase();
+        dictionary = dictionary.filter((w) => w.logicalName.toLowerCase().includes(lowerKeyword) || w.physicalName.toLowerCase().includes(lowerKeyword) || (w.synonyms ?? []).some((s) => s.toLowerCase().includes(lowerKeyword)) || w.classifier && w.classifier.toLowerCase().includes(lowerKeyword));
       }
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(dictionary, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "search_entities",
-    "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0\uC11C \uC774\uB984\uC73C\uB85C \uC5D4\uD130\uD2F0\uB97C \uAC80\uC0C9\uD569\uB2C8\uB2E4. \uB17C\uB9AC\uBA85/\uBB3C\uB9AC\uBA85 \uBAA8\uB450 \uAC80\uC0C9 \uAC00\uB2A5\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      query: external_exports.string().describe("\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC (\uC5D4\uD130\uD2F0 \uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)")
-    },
-    async ({ diagramId, query }) => {
-      try {
-        const entities = await client.searchEntities(diagramId, query);
-        const summary = entities.map((e) => ({
-          id: e.id,
-          name: e.name,
+  });
+  server.tool("analyze_legacy_sql", "\uBCF5\uC7A1\uD55C \uB808\uAC70\uC2DC SQL \uCFFC\uB9AC\uB97C \uBD84\uC11D\uD558\uC5EC ERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0 \uAE30\uBC18\uD55C \uD14C\uC774\uBE14\uB4E4\uC758 \uBE44\uC988\uB2C8\uC2A4 \uC758\uBBF8 \uBC0F \uC5F0\uAD00 \uAD00\uACC4\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    sqlQuery: external_exports.string().describe("\uBD84\uC11D\uD560 \uB300\uC0C1 SQL \uCFFC\uB9AC")
+  }, async ({ diagramId, sqlQuery }) => {
+    try {
+      const data = await client.getDiagram(diagramId);
+      const queryUpper = sqlQuery.toUpperCase();
+      const matchedEntities = data.entities.filter((e) => e.tableName && queryUpper.includes(e.tableName.toUpperCase()));
+      const matchedEntityIds = new Set(matchedEntities.map((e) => e.id));
+      const matchedRelationships = data.relationships.filter((r) => matchedEntityIds.has(r.sourceEntityId) || matchedEntityIds.has(r.targetEntityId));
+      const { extractFrequentTokens: extractFrequentTokens2 } = await Promise.resolve().then(() => (init_src(), src_exports));
+      const harvested = extractFrequentTokens2(matchedEntities, [], 1);
+      const result = {
+        message: "SQL \uB0B4\uC5D0\uC11C \uC2DD\uBCC4\uB41C \uD14C\uC774\uBE14\uC5D0 \uB300\uD55C \uBE44\uC988\uB2C8\uC2A4 \uBD84\uC11D \uACB0\uACFC\uC785\uB2C8\uB2E4.",
+        matchedTables: matchedEntities.map((e) => ({
           tableName: e.tableName,
-          role: e.entityRole,
-          columnCount: e.columns.length,
-          columns: e.columns.map((c) => `${c.name} (${c.type})${c.isPrimaryKey ? " [PK]" : ""}${c.isForeignKey ? " [FK]" : ""}`)
-        }));
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(summary, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "generate_ddl",
-    "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 DDL(CREATE TABLE \uAD6C\uBB38)\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4. PostgreSQL, MySQL, Oracle \uB4F1 \uB2E4\uC591\uD55C \uBC29\uC5B8\uC744 \uC9C0\uC6D0\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      dialect: external_exports.enum(["postgresql", "mysql", "oracle", "mssql", "sqlite"]).optional().default("postgresql").describe("SQL \uBC29\uC5B8 (\uAE30\uBCF8\uAC12: postgresql)")
-    },
-    async ({ diagramId, dialect }) => {
-      try {
-        const ddl = await client.generateDDL(diagramId, dialect);
-        return {
-          content: [{
-            type: "text",
-            text: typeof ddl === "string" ? ddl : JSON.stringify(ddl)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "validate_schema",
-    "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uC2A4\uD0A4\uB9C8\uB97C \uAC80\uC99D\uD569\uB2C8\uB2E4. \uB204\uB77D\uB41C PK, \uBBF8\uC5F0\uACB0 FK, \uBE44\uD45C\uC900 \uB124\uC774\uBC0D \uB4F1\uC744 \uC810\uAC80\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID")
-    },
-    async ({ diagramId }) => {
-      try {
-        const data = await client.getDiagram(diagramId);
-        const issues = [];
-        for (const entity of data.entities) {
-          const hasPK = entity.columns.some((c) => c.isPrimaryKey);
-          if (!hasPK) {
-            issues.push(`\u26A0\uFE0F [${entity.name}] PK(Primary Key)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-          }
-        }
-        for (const entity of data.entities) {
-          if (entity.columns.length === 0) {
-            issues.push(`\u26A0\uFE0F [${entity.name}] \uCEEC\uB7FC\uC774 \uD558\uB098\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-          }
-        }
-        const connectedIds = /* @__PURE__ */ new Set();
-        for (const rel of data.relationships) {
-          connectedIds.add(rel.sourceEntityId);
-          connectedIds.add(rel.targetEntityId);
-        }
-        for (const entity of data.entities) {
-          if (!connectedIds.has(entity.id) && data.entities.length > 1) {
-            issues.push(`\u2139\uFE0F [${entity.name}] \uB2E4\uB978 \uC5D4\uD130\uD2F0\uC640 \uAD00\uACC4\uAC00 \uC5C6\uB294 \uACE0\uB9BD \uC5D4\uD130\uD2F0\uC785\uB2C8\uB2E4.`);
-          }
-        }
-        const summary = issues.length === 0 ? `\u2705 \uC2A4\uD0A4\uB9C8 \uAC80\uC99D \uC644\uB8CC: ${data.entities.length}\uAC1C \uC5D4\uD130\uD2F0, \uBB38\uC81C \uC5C6\uC74C.` : `\u{1F50D} \uC2A4\uD0A4\uB9C8 \uAC80\uC99D \uC644\uB8CC: ${data.entities.length}\uAC1C \uC5D4\uD130\uD2F0, ${issues.length}\uAC1C \uC774\uC288 \uBC1C\uACAC.
-
-${issues.join("\n")}`;
-        return {
-          content: [{
-            type: "text",
-            text: summary
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "harvest_schema_semantics",
-    "ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uBB3C\uB9AC \uD14C\uC774\uBE14 \uBAA9\uB85D\uC744 \uAE30\uBC18\uC73C\uB85C \uC5ED\uACF5\uD559 \uCD94\uB860\uC744 \uC2E4\uD589\uD558\uC5EC \uB17C\uB9AC\uBA85, \uC124\uBA85, \uAD00\uACC4 \uB4F1\uC758 \uC2DC\uBA58\uD2F1 \uBA54\uD0C0\uB370\uC774\uD130\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      tableNames: external_exports.array(external_exports.string()).optional().describe("\uCD94\uCD9C\uD560 \uBB3C\uB9AC \uD14C\uC774\uBE14\uBA85 \uBAA9\uB85D. \uC0DD\uB7B5 \uC2DC \uC804\uCCB4 \uB2E4\uC774\uC5B4\uADF8\uB7A8 \uB300\uC0C1")
-    },
-    async ({ diagramId, tableNames }) => {
-      try {
-        const data = await client.getDiagram(diagramId);
-        let entities = data.entities;
-        if (tableNames && tableNames.length > 0) {
-          const tableSet = new Set(tableNames.map((t) => t.toUpperCase()));
-          entities = entities.filter((e) => e.tableName && tableSet.has(e.tableName.toUpperCase()));
-        }
-        const { extractFrequentTokens: extractFrequentTokens2 } = await Promise.resolve().then(() => (init_src(), src_exports));
-        const harvested = extractFrequentTokens2(entities, [], 1);
-        const summary = {
-          extractedSemantics: harvested,
-          relationships: data.relationships.filter(
-            (r) => entities.some((e) => e.id === r.sourceEntityId) || entities.some((e) => e.id === r.targetEntityId)
-          )
-        };
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(summary, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "propose_schema_change",
-    "\uC678\uBD80 AI\uAC00 ThinkERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0 \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD\uC744 \uC81C\uC548\uD569\uB2C8\uB2E4. \uC0AC\uC6A9\uC790 \uC2B9\uC778\uC774 \uD544\uC694\uD55C Draft\uB85C \uC804\uC1A1\uB429\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB300\uC0C1 \uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      entityName: external_exports.string().describe("\uBCC0\uACBD \uB300\uC0C1 \uC5D4\uD130\uD2F0\uBA85 (\uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)"),
-      changeType: external_exports.enum(["add_column", "modify_column", "add_entity"]).describe("\uBCC0\uACBD \uC720\uD615"),
-      changeData: external_exports.record(external_exports.unknown()).describe("\uBCC0\uACBD \uB370\uC774\uD130 (JSON). add_column: {name, type, logicalName}, add_entity: {name, tableName, columns}"),
-      reason: external_exports.string().describe("\uBCC0\uACBD \uC0AC\uC720")
-    },
-    async ({ diagramId, entityName, changeType, changeData, reason }) => {
-      try {
-        const draft = await client.proposeSchemaChange(diagramId, {
-          entityName,
-          changeType,
-          changeData,
-          reason
-        });
-        return {
-          content: [{
-            type: "text",
-            text: `\u2705 \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD \uC81C\uC548\uC774 ThinkERD\uC5D0 \uC804\uC1A1\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
-
-Draft ID: ${draft.draft_id}
-\uC0C1\uD0DC: ${draft.status}
-\uB300\uC0C1: ${entityName}
-\uC720\uD615: ${changeType}
-\uC0AC\uC720: ${reason}
-
-\u26A0\uFE0F ThinkERD\uC5D0\uC11C \uC0AC\uC6A9\uC790\uAC00 \uC774 \uC81C\uC548\uC744 \uC2B9\uC778\uD574\uC57C \uC801\uC6A9\uB429\uB2C8\uB2E4.`
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "get_business_dictionary",
-    "\uC0AC\uB0B4 \uD45C\uC900 \uB2E8\uC5B4/\uC6A9\uC5B4 \uC0AC\uC804\uC5D0\uC11C \uD0A4\uC6CC\uB4DC\uB97C \uAC80\uC0C9\uD558\uC5EC \uB17C\uB9AC\uBA85-\uBB3C\uB9AC\uBA85 \uB9E4\uD551 \uAC00\uC774\uB4DC\uB97C \uC81C\uACF5\uD569\uB2C8\uB2E4. \uAC01 \uB2E8\uC5B4\uC758 \uB3D9\uC758\uC5B4(synonyms)\uB3C4 \uD568\uAED8 \uBC18\uD658\uD558\uBBC0\uB85C, \uC0AC\uC6A9\uC790\uAC00 \uC4F4 \uB9D0\uC774 \uC0AC\uB0B4\uC5D0\uC11C \uC5B4\uB5A4 \uD45C\uC900 \uB2E8\uC5B4\uC778\uC9C0 \uB418\uC9DA\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
-    {
-      projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
-      keyword: external_exports.string().optional().describe("\uAC80\uC0C9\uC5B4 (\uC0DD\uB7B5 \uC2DC \uC804\uCCB4 \uC870\uD68C). \uB3D9\uC758\uC5B4\uB85C\uB3C4 \uAC80\uC0C9\uB429\uB2C8\uB2E4")
-    },
-    async ({ projectId, keyword }) => {
-      try {
-        let dictionary = await client.getDictionary(projectId);
-        if (keyword) {
-          const lowerKeyword = keyword.toLowerCase();
-          dictionary = dictionary.filter(
-            (w) => w.logicalName.toLowerCase().includes(lowerKeyword) || w.physicalName.toLowerCase().includes(lowerKeyword) || (w.synonyms ?? []).some((s) => s.toLowerCase().includes(lowerKeyword)) || w.classifier && w.classifier.toLowerCase().includes(lowerKeyword)
-          );
-        }
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(dictionary, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
+          logicalName: e.logicalName,
+          description: e.columns.map((c) => `${c.name}(${c.type}) ${c.logicalName || ""}`).join(", ")
+        })),
+        semanticHarvest: harvested,
+        relevantRelationships: matchedRelationships
+      };
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "analyze_legacy_sql",
-    "\uBCF5\uC7A1\uD55C \uB808\uAC70\uC2DC SQL \uCFFC\uB9AC\uB97C \uBD84\uC11D\uD558\uC5EC ERD \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC5D0 \uAE30\uBC18\uD55C \uD14C\uC774\uBE14\uB4E4\uC758 \uBE44\uC988\uB2C8\uC2A4 \uC758\uBBF8 \uBC0F \uC5F0\uAD00 \uAD00\uACC4\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      sqlQuery: external_exports.string().describe("\uBD84\uC11D\uD560 \uB300\uC0C1 SQL \uCFFC\uB9AC")
-    },
-    async ({ diagramId, sqlQuery }) => {
-      try {
-        const data = await client.getDiagram(diagramId);
-        const queryUpper = sqlQuery.toUpperCase();
-        const matchedEntities = data.entities.filter(
-          (e) => e.tableName && queryUpper.includes(e.tableName.toUpperCase())
-        );
-        const matchedEntityIds = new Set(matchedEntities.map((e) => e.id));
-        const matchedRelationships = data.relationships.filter(
-          (r) => matchedEntityIds.has(r.sourceEntityId) || matchedEntityIds.has(r.targetEntityId)
-        );
-        const { extractFrequentTokens: extractFrequentTokens2 } = await Promise.resolve().then(() => (init_src(), src_exports));
-        const harvested = extractFrequentTokens2(matchedEntities, [], 1);
-        const result = {
-          message: "SQL \uB0B4\uC5D0\uC11C \uC2DD\uBCC4\uB41C \uD14C\uC774\uBE14\uC5D0 \uB300\uD55C \uBE44\uC988\uB2C8\uC2A4 \uBD84\uC11D \uACB0\uACFC\uC785\uB2C8\uB2E4.",
-          matchedTables: matchedEntities.map((e) => ({
+  });
+  server.tool("semantic_search", "\uBE44\uC988\uB2C8\uC2A4 \uC6A9\uC5B4(\uC790\uC5F0\uC5B4)\uB85C \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uC5D4\uD130\uD2F0\xB7\uCEEC\uB7FC\uC744 \uAC80\uC0C9\uD569\uB2C8\uB2E4. \uB3D9\uC758\uC5B4, \uC124\uBA85, \uB17C\uB9AC\uBA85\uC744 \uBAA8\uB450 \uD65C\uC6A9\uD558\uC5EC \uB9E4\uCE6D\uD558\uBA70, \uB9E4\uCE6D \uC720\uD615(\uB17C\uB9AC\uBA85/\uB3D9\uC758\uC5B4/\uC124\uBA85/\uBD80\uBD84\uB9E4\uCE6D/\uCEEC\uB7FC)\uC744 \uD568\uAED8 \uBC18\uD658\uD569\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    query: external_exports.string().describe("\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC (\uBE44\uC988\uB2C8\uC2A4 \uC6A9\uC5B4, \uB17C\uB9AC\uBA85, \uB3D9\uC758\uC5B4 \uB4F1)"),
+    maxResults: external_exports.number().optional().describe("\uCD5C\uB300 \uACB0\uACFC \uC218 (\uAE30\uBCF8 10)")
+  }, async ({ diagramId, query, maxResults }) => {
+    try {
+      const data = await client.getDiagram(diagramId);
+      const entities = data.entities || [];
+      const limit = maxResults || 10;
+      const q = query.toLowerCase();
+      const results = [];
+      for (const entity of entities) {
+        const e = entity;
+        if (e.name?.toLowerCase().includes(q) || e.logicalName?.toLowerCase().includes(q)) {
+          results.push({
+            entityId: e.id,
+            entityName: e.name,
             tableName: e.tableName,
-            logicalName: e.logicalName,
-            description: e.columns.map((c) => `${c.name}(${c.type}) ${c.logicalName || ""}`).join(", ")
-          })),
-          semanticHarvest: harvested,
-          relevantRelationships: matchedRelationships
-        };
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "semantic_search",
-    "\uBE44\uC988\uB2C8\uC2A4 \uC6A9\uC5B4(\uC790\uC5F0\uC5B4)\uB85C \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uC5D4\uD130\uD2F0\xB7\uCEEC\uB7FC\uC744 \uAC80\uC0C9\uD569\uB2C8\uB2E4. \uB3D9\uC758\uC5B4, \uC124\uBA85, \uB17C\uB9AC\uBA85\uC744 \uBAA8\uB450 \uD65C\uC6A9\uD558\uC5EC \uB9E4\uCE6D\uD558\uBA70, \uB9E4\uCE6D \uC720\uD615(\uB17C\uB9AC\uBA85/\uB3D9\uC758\uC5B4/\uC124\uBA85/\uBD80\uBD84\uB9E4\uCE6D/\uCEEC\uB7FC)\uC744 \uD568\uAED8 \uBC18\uD658\uD569\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      query: external_exports.string().describe("\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC (\uBE44\uC988\uB2C8\uC2A4 \uC6A9\uC5B4, \uB17C\uB9AC\uBA85, \uB3D9\uC758\uC5B4 \uB4F1)"),
-      maxResults: external_exports.number().optional().describe("\uCD5C\uB300 \uACB0\uACFC \uC218 (\uAE30\uBCF8 10)")
-    },
-    async ({ diagramId, query, maxResults }) => {
-      try {
-        const data = await client.getDiagram(diagramId);
-        const entities = data.entities || [];
-        const limit = maxResults || 10;
-        const q = query.toLowerCase();
-        const results = [];
-        for (const entity of entities) {
-          const e = entity;
-          if (e.name?.toLowerCase().includes(q) || e.logicalName?.toLowerCase().includes(q)) {
+            matchType: "logicalName",
+            matchedOn: e.name || e.logicalName,
+            description: e.description || null
+          });
+          continue;
+        }
+        if (Array.isArray(e.synonyms)) {
+          const syn = e.synonyms.find((s) => s.toLowerCase().includes(q));
+          if (syn) {
             results.push({
               entityId: e.id,
               entityName: e.name,
               tableName: e.tableName,
-              matchType: "logicalName",
-              matchedOn: e.name || e.logicalName,
+              matchType: "synonym",
+              matchedOn: syn,
               description: e.description || null
             });
             continue;
           }
-          if (Array.isArray(e.synonyms)) {
-            const syn = e.synonyms.find((s) => s.toLowerCase().includes(q));
-            if (syn) {
-              results.push({
-                entityId: e.id,
-                entityName: e.name,
-                tableName: e.tableName,
-                matchType: "synonym",
-                matchedOn: syn,
-                description: e.description || null
-              });
-              continue;
-            }
-          }
-          if (e.description?.toLowerCase().includes(q)) {
+        }
+        if (e.description?.toLowerCase().includes(q)) {
+          results.push({
+            entityId: e.id,
+            entityName: e.name,
+            tableName: e.tableName,
+            matchType: "description",
+            matchedOn: e.description
+          });
+          continue;
+        }
+        for (const col of entity.columns) {
+          const c = col;
+          if (c.logicalName?.toLowerCase().includes(q) || c.name?.toLowerCase().includes(q) || c.description?.toLowerCase().includes(q)) {
             results.push({
               entityId: e.id,
               entityName: e.name,
               tableName: e.tableName,
-              matchType: "description",
-              matchedOn: e.description
+              matchType: "column",
+              matchedColumn: c.name,
+              matchedColumnLogical: c.logicalName
             });
-            continue;
-          }
-          for (const col of entity.columns) {
-            const c = col;
-            if (c.logicalName?.toLowerCase().includes(q) || c.name?.toLowerCase().includes(q) || c.description?.toLowerCase().includes(q)) {
-              results.push({
-                entityId: e.id,
-                entityName: e.name,
-                tableName: e.tableName,
-                matchType: "column",
-                matchedColumn: c.name,
-                matchedColumnLogical: c.logicalName
-              });
-              break;
-            }
+            break;
           }
         }
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify({
-              query,
-              totalResults: results.length,
-              results: results.slice(0, limit)
-            }, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
       }
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            query,
+            totalResults: results.length,
+            results: results.slice(0, limit)
+          }, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "get_business_context",
-    "\uD2B9\uC815 \uC5D4\uD130\uD2F0\uC758 \uBE44\uC988\uB2C8\uC2A4 \uC758\uBBF8, \uB3D9\uC758\uC5B4, \uCF54\uB4DC\uAC12, \uAD00\uACC4\uB97C \uD3EC\uD568\uD55C \uC804\uCCB4 \uBE44\uC988\uB2C8\uC2A4 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4. Text-to-SQL\uC774\uB098 \uBB38\uC11C \uC0DD\uC131\uC758 \uCC38\uACE0\uC790\uB8CC\uB85C \uD65C\uC6A9\uB429\uB2C8\uB2E4.",
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      entityId: external_exports.string().describe("\uC5D4\uD130\uD2F0 ID")
-    },
-    async ({ diagramId, entityId }) => {
-      try {
-        const entity = await client.getEntity(diagramId, entityId);
-        const data = await client.getDiagram(diagramId);
-        const e = entity;
-        const relationships = (data.relationships || []).filter(
-          (r) => r.sourceEntityId === entityId || r.targetEntityId === entityId
-        );
-        const businessContext = {
-          entity: {
-            id: e.id,
-            name: e.name,
-            tableName: e.tableName,
-            logicalName: e.logicalName || e.name,
-            description: e.description || null,
-            synonyms: e.synonyms || [],
-            entityRole: e.entityRole || null
-          },
-          columns: entity.columns.map((c) => ({
+  });
+  server.tool("get_business_context", "\uD2B9\uC815 \uC5D4\uD130\uD2F0\uC758 \uBE44\uC988\uB2C8\uC2A4 \uC758\uBBF8, \uB3D9\uC758\uC5B4, \uCF54\uB4DC\uAC12, \uAD00\uACC4\uB97C \uD3EC\uD568\uD55C \uC804\uCCB4 \uBE44\uC988\uB2C8\uC2A4 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4. Text-to-SQL\uC774\uB098 \uBB38\uC11C \uC0DD\uC131\uC758 \uCC38\uACE0\uC790\uB8CC\uB85C \uD65C\uC6A9\uB429\uB2C8\uB2E4.", {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    entityId: external_exports.string().describe("\uC5D4\uD130\uD2F0 ID")
+  }, async ({ diagramId, entityId }) => {
+    try {
+      const entity = await client.getEntity(diagramId, entityId);
+      const data = await client.getDiagram(diagramId);
+      const e = entity;
+      const relationships = (data.relationships || []).filter((r) => r.sourceEntityId === entityId || r.targetEntityId === entityId);
+      const businessContext = {
+        entity: {
+          id: e.id,
+          name: e.name,
+          tableName: e.tableName,
+          logicalName: e.logicalName || e.name,
+          description: e.description || null,
+          synonyms: e.synonyms || [],
+          entityRole: e.entityRole || null
+        },
+        columns: entity.columns.map((c) => ({
+          name: c.name,
+          logicalName: c.logicalName || null,
+          type: c.type,
+          isPrimaryKey: c.isPrimaryKey || false,
+          isForeignKey: c.isForeignKey || false,
+          description: c.description || null,
+          domainValues: c.domainValues || null
+        })),
+        relationships: relationships.map((r) => ({
+          relatedEntity: r.sourceEntityId === entityId ? r.targetEntityName : r.sourceEntityName,
+          direction: r.sourceEntityId === entityId ? "outgoing" : "incoming",
+          type: r.type,
+          cardinality: `${r.sourceCardinality}:${r.targetCardinality}`
+        }))
+      };
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(businessContext, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
+    }
+  });
+  server.tool("generate_sql", '**\uD55C \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uBB3C\uB9AC \uC2A4\uD0A4\uB9C8\uB9CC** \uBCF4\uACE0 SQL \uC791\uC131\uC6A9 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4. \u26A0\uFE0F \uC774 \uB3C4\uAD6C\uB294 \uD504\uB85C\uC81D\uD2B8 \uC804\uC5ED \uC758\uBBF8 \uACC4\uCE35(\uBE44\uC988\uB2C8\uC2A4 \uBAA8\uB378 \uBC1C\uD589\uBCF8\xB7\uD45C\uC900 \uC0AC\uC804 \uB3D9\uC758\uC5B4\xB7\uC628\uD1A8\uB85C\uC9C0)\uC744 **\uBCF4\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.** \uC5C5\uBB34 \uC6A9\uC5B4("\uACE0\uAC1D", "\uBC30\uC1A1\uC911\uC778 \uC8FC\uBB38")\uAC00 \uC11E\uC778 \uC9C8\uBB38\uC774\uB77C\uBA74 **`get_project_context`\uB97C \uBA3C\uC800 \uD638\uCD9C\uD558\uC2ED\uC2DC\uC624.** \uC774 \uB3C4\uAD6C\uB294 \uB300\uC0C1 \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC774 \uC774\uBBF8 \uD2B9\uC815\uB418\uC5B4 \uC788\uACE0 \uBB3C\uB9AC \uCEEC\uB7FC \uAD6C\uC870\uB9CC \uD544\uC694\uD560 \uB54C \uC4F0\uC2ED\uC2DC\uC624.', {
+    diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
+    question: external_exports.string().describe('\uC790\uC5F0\uC5B4 \uC9C8\uBB38 (\uC608: "\uBD80\uC11C\uBCC4 \uD3C9\uADE0 \uAE09\uC5EC\uAC00 5\uCC9C\uB9CC\uC6D0 \uC774\uC0C1\uC778 \uBD80\uC11C")'),
+    dialect: external_exports.string().optional().describe("SQL \uBC29\uC5B8 (postgresql, mysql, oracle, mssql). \uAE30\uBCF8: postgresql")
+  }, async ({ diagramId, question, dialect }) => {
+    try {
+      const data = await client.getDiagram(diagramId);
+      const entities = data.entities || [];
+      const relationships = data.relationships || [];
+      const schemaContext = entities.map((e) => {
+        const ea = e;
+        return {
+          tableName: e.tableName,
+          logicalName: e.name || ea.logicalName,
+          description: ea.description || null,
+          synonyms: ea.synonyms || [],
+          columns: e.columns.map((c) => ({
             name: c.name,
             logicalName: c.logicalName || null,
             type: c.type,
             isPrimaryKey: c.isPrimaryKey || false,
             isForeignKey: c.isForeignKey || false,
-            description: c.description || null,
             domainValues: c.domainValues || null
-          })),
-          relationships: relationships.map((r) => ({
-            relatedEntity: r.sourceEntityId === entityId ? r.targetEntityName : r.sourceEntityName,
-            direction: r.sourceEntityId === entityId ? "outgoing" : "incoming",
-            type: r.type,
-            cardinality: `${r.sourceCardinality}:${r.targetCardinality}`
           }))
         };
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(businessContext, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
-    }
-  );
-  server.tool(
-    "generate_sql",
-    '**\uD55C \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC758 \uBB3C\uB9AC \uC2A4\uD0A4\uB9C8\uB9CC** \uBCF4\uACE0 SQL \uC791\uC131\uC6A9 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4. \u26A0\uFE0F \uC774 \uB3C4\uAD6C\uB294 \uD504\uB85C\uC81D\uD2B8 \uC804\uC5ED \uC758\uBBF8 \uACC4\uCE35(\uBE44\uC988\uB2C8\uC2A4 \uBAA8\uB378 \uBC1C\uD589\uBCF8\xB7\uD45C\uC900 \uC0AC\uC804 \uB3D9\uC758\uC5B4\xB7\uC628\uD1A8\uB85C\uC9C0)\uC744 **\uBCF4\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.** \uC5C5\uBB34 \uC6A9\uC5B4("\uACE0\uAC1D", "\uBC30\uC1A1\uC911\uC778 \uC8FC\uBB38")\uAC00 \uC11E\uC778 \uC9C8\uBB38\uC774\uB77C\uBA74 **`get_project_context`\uB97C \uBA3C\uC800 \uD638\uCD9C\uD558\uC2ED\uC2DC\uC624.** \uC774 \uB3C4\uAD6C\uB294 \uB300\uC0C1 \uB2E4\uC774\uC5B4\uADF8\uB7A8\uC774 \uC774\uBBF8 \uD2B9\uC815\uB418\uC5B4 \uC788\uACE0 \uBB3C\uB9AC \uCEEC\uB7FC \uAD6C\uC870\uB9CC \uD544\uC694\uD560 \uB54C \uC4F0\uC2ED\uC2DC\uC624.',
-    {
-      diagramId: external_exports.string().describe("\uB2E4\uC774\uC5B4\uADF8\uB7A8 ID"),
-      question: external_exports.string().describe('\uC790\uC5F0\uC5B4 \uC9C8\uBB38 (\uC608: "\uBD80\uC11C\uBCC4 \uD3C9\uADE0 \uAE09\uC5EC\uAC00 5\uCC9C\uB9CC\uC6D0 \uC774\uC0C1\uC778 \uBD80\uC11C")'),
-      dialect: external_exports.string().optional().describe("SQL \uBC29\uC5B8 (postgresql, mysql, oracle, mssql). \uAE30\uBCF8: postgresql")
-    },
-    async ({ diagramId, question, dialect }) => {
-      try {
-        const data = await client.getDiagram(diagramId);
-        const entities = data.entities || [];
-        const relationships = data.relationships || [];
-        const schemaContext = entities.map((e) => {
-          const ea = e;
-          return {
-            tableName: e.tableName,
-            logicalName: e.name || ea.logicalName,
-            description: ea.description || null,
-            synonyms: ea.synonyms || [],
-            columns: e.columns.map((c) => ({
-              name: c.name,
-              logicalName: c.logicalName || null,
-              type: c.type,
-              isPrimaryKey: c.isPrimaryKey || false,
-              isForeignKey: c.isForeignKey || false,
-              domainValues: c.domainValues || null
-            }))
-          };
-        });
-        const relationshipContext = relationships.map((r) => ({
-          from: `${r.sourceEntityName} (${r.sourceEntityId})`,
-          to: `${r.targetEntityName} (${r.targetEntityId})`,
-          type: r.type
-        }));
-        const result = {
-          question,
-          dialect: dialect || "postgresql",
-          schemaContext,
-          relationshipContext,
-          hint: `\uC704 \uC2A4\uD0A4\uB9C8 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uAE30\uBC18\uC73C\uB85C "${question}"\uC5D0 \uB300\uD55C ${dialect || "postgresql"} SQL\uC744 \uC0DD\uC131\uD558\uC138\uC694. tableName\uC744 \uD14C\uC774\uBE14 \uCC38\uC870\uC5D0, columns[].name\uC744 \uCEEC\uB7FC \uCC38\uC870\uC5D0 \uC0AC\uC6A9\uD558\uC138\uC694. \uB3D9\uC758\uC5B4(synonyms)\uC640 \uCF54\uB4DC\uAC12(domainValues)\uC744 \uD65C\uC6A9\uD558\uC5EC \uC815\uD655\uD55C \uB9E4\uD551\uC744 \uC218\uD589\uD558\uC138\uC694.`
-        };
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
+      });
+      const relationshipContext = relationships.map((r) => ({
+        from: `${r.sourceEntityName} (${r.sourceEntityId})`,
+        to: `${r.targetEntityName} (${r.targetEntityId})`,
+        type: r.type
+      }));
+      const result = {
+        question,
+        dialect: dialect || "postgresql",
+        schemaContext,
+        relationshipContext,
+        hint: `\uC704 \uC2A4\uD0A4\uB9C8 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uAE30\uBC18\uC73C\uB85C "${question}"\uC5D0 \uB300\uD55C ${dialect || "postgresql"} SQL\uC744 \uC0DD\uC131\uD558\uC138\uC694. tableName\uC744 \uD14C\uC774\uBE14 \uCC38\uC870\uC5D0, columns[].name\uC744 \uCEEC\uB7FC \uCC38\uC870\uC5D0 \uC0AC\uC6A9\uD558\uC138\uC694. \uB3D9\uC758\uC5B4(synonyms)\uC640 \uCF54\uB4DC\uAC12(domainValues)\uC744 \uD65C\uC6A9\uD558\uC5EC \uC815\uD655\uD55C \uB9E4\uD551\uC744 \uC218\uD589\uD558\uC138\uC694.`
+      };
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "get_project_context",
-    '**\uC5C5\uBB34 \uC6A9\uC5B4\uAC00 \uC11E\uC778 \uC9C8\uBB38\uC5D0\uB294 \uC774 \uB3C4\uAD6C\uB97C \uBA3C\uC800 \uC4F0\uC2ED\uC2DC\uC624.** \uC790\uC5F0\uC5B4 \uC9C8\uBB38\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8 \uC804\uCCB4\uC5D0\uC11C \uAD00\uB828 \uC5D4\uD130\uD2F0\uB97C \uC2DC\uBA58\uD2F1 \uAC80\uC0C9(Graph RAG)\uD569\uB2C8\uB2E4. \uC774 \uC870\uC9C1\uC774 \uC4F0\uB294 **\uB3D9\uC758\uC5B4\xB7\uCF54\uB4DC\uAC12\uC758 \uB73B\xB7\uBE44\uC988\uB2C8\uC2A4 \uBAA8\uB378 \uBC1C\uD589\uBCF8**\uAE4C\uC9C0 \uBCF4\uBBC0\uB85C, "\uACE0\uAC1D"\uCC98\uB7FC \uBB3C\uB9AC \uC2A4\uD0A4\uB9C8\uC5D0 \uC5C6\uB294 \uB9D0\uB3C4 \uC2E4\uC81C \uD14C\uC774\uBE14\uB85C \uC5F0\uACB0\uD569\uB2C8\uB2E4. \uC751\uB2F5\uC758 `usedFallback: true`\uB294 **\uC9C8\uBB38\uC758 \uAC1C\uB150\uC744 \uCC3E\uC9C0 \uBABB\uD588\uB2E4**\uB294 \uB73B\uC785\uB2C8\uB2E4 \u2014 \uADF8 \uCEE8\uD14D\uC2A4\uD2B8\uB85C SQL\uC744 \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0 \uBAA8\uB978\uB2E4\uACE0 \uB2F5\uD558\uAC70\uB098 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC6A9\uC5B4\uB97C \uB418\uBB3C\uC73C\uC2ED\uC2DC\uC624.',
-    {
-      projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
-      question: external_exports.string().describe('\uC790\uC5F0\uC5B4 \uC9C8\uBB38 (\uC608: "\uBD80\uC11C\uBCC4 \uAE09\uC5EC \uCD1D\uC561", "VIP \uACE0\uAC1D\uC758 \uCD5C\uADFC \uC8FC\uBB38")')
-    },
-    async ({ projectId, question }) => {
-      try {
-        const result = await client.getProjectContext(projectId, question);
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
+  });
+  server.tool("get_project_context", '**\uC5C5\uBB34 \uC6A9\uC5B4\uAC00 \uC11E\uC778 \uC9C8\uBB38\uC5D0\uB294 \uC774 \uB3C4\uAD6C\uB97C \uBA3C\uC800 \uC4F0\uC2ED\uC2DC\uC624.** \uC790\uC5F0\uC5B4 \uC9C8\uBB38\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8 \uC804\uCCB4\uC5D0\uC11C \uAD00\uB828 \uC5D4\uD130\uD2F0\uB97C \uC2DC\uBA58\uD2F1 \uAC80\uC0C9(Graph RAG)\uD569\uB2C8\uB2E4. \uC774 \uC870\uC9C1\uC774 \uC4F0\uB294 **\uB3D9\uC758\uC5B4\xB7\uCF54\uB4DC\uAC12\uC758 \uB73B\xB7\uBE44\uC988\uB2C8\uC2A4 \uBAA8\uB378 \uBC1C\uD589\uBCF8**\uAE4C\uC9C0 \uBCF4\uBBC0\uB85C, "\uACE0\uAC1D"\uCC98\uB7FC \uBB3C\uB9AC \uC2A4\uD0A4\uB9C8\uC5D0 \uC5C6\uB294 \uB9D0\uB3C4 \uC2E4\uC81C \uD14C\uC774\uBE14\uB85C \uC5F0\uACB0\uD569\uB2C8\uB2E4. \uC751\uB2F5\uC758 `usedFallback: true`\uB294 **\uC9C8\uBB38\uC758 \uAC1C\uB150\uC744 \uCC3E\uC9C0 \uBABB\uD588\uB2E4**\uB294 \uB73B\uC785\uB2C8\uB2E4 \u2014 \uADF8 \uCEE8\uD14D\uC2A4\uD2B8\uB85C SQL\uC744 \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0 \uBAA8\uB978\uB2E4\uACE0 \uB2F5\uD558\uAC70\uB098 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC6A9\uC5B4\uB97C \uB418\uBB3C\uC73C\uC2ED\uC2DC\uC624.', {
+    projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
+    question: external_exports.string().describe('\uC790\uC5F0\uC5B4 \uC9C8\uBB38 (\uC608: "\uBD80\uC11C\uBCC4 \uAE09\uC5EC \uCD1D\uC561", "VIP \uACE0\uAC1D\uC758 \uCD5C\uADFC \uC8FC\uBB38")')
+  }, async ({ projectId, question }) => {
+    try {
+      const result = await client.getProjectContext(projectId, question);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "find_join_path",
-    "\uB450 \uC5D4\uD130\uD2F0(\uD14C\uC774\uBE14) \uAC04 \uCD5C\uC801 JOIN \uACBD\uB85C\uB97C \uD0D0\uC0C9\uD569\uB2C8\uB2E4. BFS \uAE30\uBC18\uC73C\uB85C \uCD5C\uB2E8 \uACBD\uB85C\uB97C \uCC3E\uC73C\uBA70, \uC911\uAC04 \uD14C\uC774\uBE14\uACFC \uAD00\uACC4\uBA85\uC744 \uD3EC\uD568\uD569\uB2C8\uB2E4. \uAC01 \uAD6C\uAC04\uC5D0 \uBB3C\uB9AC \uD14C\uC774\uBE14\uBA85\xB7FK \uCEEC\uB7FC\uC30D(on)\xB7\uC9C4\uD589 \uBC29\uD5A5 \uCE74\uB514\uB110\uB9AC\uD2F0\uAC00 \uC2E4\uB824 \uC788\uC73C\uBBC0\uB85C, **\uC870\uC778 \uC870\uAC74\uC744 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 on \uAC12\uC744 \uADF8\uB300\uB85C ON \uC808\uC5D0 \uC4F0\uC2ED\uC2DC\uC624.** joinable=false\uBA74 FK \uB9E4\uD551\uC774\uB098 \uBB3C\uB9AC \uD14C\uC774\uBE14\uBA85\uC774 \uC5C6\uC5B4 SQL\uC744 \uC870\uB9BD\uD560 \uC218 \uC5C6\uB2E4\uB294 \uB73B\uC774\uBA70, \uC0AC\uC720\uB294 warnings\uC5D0 \uC788\uC2B5\uB2C8\uB2E4.",
-    {
-      projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
-      from: external_exports.string().describe("\uCD9C\uBC1C \uC5D4\uD130\uD2F0 \uC774\uB984 (\uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)"),
-      to: external_exports.string().describe("\uB3C4\uCC29 \uC5D4\uD130\uD2F0 \uC774\uB984 (\uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)")
-    },
-    async ({ projectId, from, to }) => {
-      try {
-        const result = await client.findJoinPath(projectId, from, to);
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
+  });
+  server.tool("find_join_path", "\uB450 \uC5D4\uD130\uD2F0(\uD14C\uC774\uBE14) \uAC04 \uCD5C\uC801 JOIN \uACBD\uB85C\uB97C \uD0D0\uC0C9\uD569\uB2C8\uB2E4. BFS \uAE30\uBC18\uC73C\uB85C \uCD5C\uB2E8 \uACBD\uB85C\uB97C \uCC3E\uC73C\uBA70, \uC911\uAC04 \uD14C\uC774\uBE14\uACFC \uAD00\uACC4\uBA85\uC744 \uD3EC\uD568\uD569\uB2C8\uB2E4. \uAC01 \uAD6C\uAC04\uC5D0 \uBB3C\uB9AC \uD14C\uC774\uBE14\uBA85\xB7FK \uCEEC\uB7FC\uC30D(on)\xB7\uC9C4\uD589 \uBC29\uD5A5 \uCE74\uB514\uB110\uB9AC\uD2F0\uAC00 \uC2E4\uB824 \uC788\uC73C\uBBC0\uB85C, **\uC870\uC778 \uC870\uAC74\uC744 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 on \uAC12\uC744 \uADF8\uB300\uB85C ON \uC808\uC5D0 \uC4F0\uC2ED\uC2DC\uC624.** joinable=false\uBA74 FK \uB9E4\uD551\uC774\uB098 \uBB3C\uB9AC \uD14C\uC774\uBE14\uBA85\uC774 \uC5C6\uC5B4 SQL\uC744 \uC870\uB9BD\uD560 \uC218 \uC5C6\uB2E4\uB294 \uB73B\uC774\uBA70, \uC0AC\uC720\uB294 warnings\uC5D0 \uC788\uC2B5\uB2C8\uB2E4.", {
+    projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
+    from: external_exports.string().describe("\uCD9C\uBC1C \uC5D4\uD130\uD2F0 \uC774\uB984 (\uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)"),
+    to: external_exports.string().describe("\uB3C4\uCC29 \uC5D4\uD130\uD2F0 \uC774\uB984 (\uB17C\uB9AC\uBA85 \uB610\uB294 \uBB3C\uB9AC\uBA85)")
+  }, async ({ projectId, from, to }) => {
+    try {
+      const result = await client.findJoinPath(projectId, from, to);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "get_project_summary",
-    "\uD504\uB85C\uC81D\uD2B8 \uC804\uCCB4\uC758 \uB370\uC774\uD130 \uBAA8\uB378 \uC694\uC57D\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4. \uC5D4\uD130\uD2F0 \uC218, \uAD00\uACC4 \uC218, \uC8FC\uC81C\uC601\uC5ED(Subject Area) \uAD6C\uC131, RDF \uD2B8\uB9AC\uD50C \uC218 \uB4F1\uC744 \uD3EC\uD568\uD569\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uC628\uBCF4\uB529\uC774\uB098 \uC804\uCCB4 \uAD6C\uC870 \uD30C\uC545\uC5D0 \uC720\uC6A9\uD569\uB2C8\uB2E4.",
-    {
-      projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID")
-    },
-    async ({ projectId }) => {
-      try {
-        const result = await client.getProjectSummary(projectId);
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
+  });
+  server.tool("get_project_summary", "\uD504\uB85C\uC81D\uD2B8 \uC804\uCCB4\uC758 \uB370\uC774\uD130 \uBAA8\uB378 \uC694\uC57D\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4. \uC5D4\uD130\uD2F0 \uC218, \uAD00\uACC4 \uC218, \uC8FC\uC81C\uC601\uC5ED(Subject Area) \uAD6C\uC131, RDF \uD2B8\uB9AC\uD50C \uC218 \uB4F1\uC744 \uD3EC\uD568\uD569\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uC628\uBCF4\uB529\uC774\uB098 \uC804\uCCB4 \uAD6C\uC870 \uD30C\uC545\uC5D0 \uC720\uC6A9\uD569\uB2C8\uB2E4.", {
+    projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID")
+  }, async ({ projectId }) => {
+    try {
+      const result = await client.getProjectSummary(projectId);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "query_ontology",
-    "\uD504\uB85C\uC81D\uD2B8\uC758 \uC628\uD1A8\uB85C\uC9C0 \uADF8\uB798\uD504\uC5D0 SPARQL \uCFFC\uB9AC\uB97C \uC9C1\uC811 \uC2E4\uD589\uD569\uB2C8\uB2E4. \uACE0\uAE09 \uC0AC\uC6A9\uC790\uAC00 \uC815\uAD50\uD55C \uC2DC\uBA58\uD2F1 \uC9C8\uC758\uB97C \uC218\uD589\uD560 \uB54C \uC0AC\uC6A9\uD569\uB2C8\uB2E4.",
-    {
-      projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
-      query: external_exports.string().describe("SPARQL SELECT \uCFFC\uB9AC\uBB38")
-    },
-    async ({ projectId, query }) => {
-      try {
-        const result = await client.queryOntology(projectId, query);
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
-      }
+  });
+  server.tool("query_ontology", "\uD504\uB85C\uC81D\uD2B8\uC758 \uC628\uD1A8\uB85C\uC9C0 \uADF8\uB798\uD504\uC5D0 SPARQL \uCFFC\uB9AC\uB97C \uC9C1\uC811 \uC2E4\uD589\uD569\uB2C8\uB2E4. \uACE0\uAE09 \uC0AC\uC6A9\uC790\uAC00 \uC815\uAD50\uD55C \uC2DC\uBA58\uD2F1 \uC9C8\uC758\uB97C \uC218\uD589\uD560 \uB54C \uC0AC\uC6A9\uD569\uB2C8\uB2E4.", {
+    projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID"),
+    query: external_exports.string().describe("SPARQL SELECT \uCFFC\uB9AC\uBB38")
+  }, async ({ projectId, query }) => {
+    try {
+      const result = await client.queryOntology(projectId, query);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
-  server.tool(
-    "check_metadata_quality",
-    "\uD504\uB85C\uC81D\uD2B8\uC758 \uBA54\uD0C0\uB370\uC774\uD130 \uD48D\uBD80\uB3C4\uB97C \uBD84\uC11D\uD569\uB2C8\uB2E4. \uC124\uBA85, \uB3D9\uC758\uC5B4, \uC18D\uC131 \uC785\uB825\uB960\uC744 \uAE30\uBC18\uC73C\uB85C \uC804\uCCB4 \uD488\uC9C8 \uC810\uC218\uB97C \uC0B0\uCD9C\uD558\uACE0, \uAC1C\uC120\uC774 \uD544\uC694\uD55C \uC5D4\uD130\uD2F0 \uBAA9\uB85D\uC744 \uC81C\uC548\uD569\uB2C8\uB2E4.",
-    {
-      projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID")
-    },
-    async ({ projectId }) => {
-      try {
-        const result = await client.checkMetadataQuality(projectId);
-        const summary = [
-          `\u{1F4CA} \uBA54\uD0C0\uB370\uC774\uD130 \uD488\uC9C8 \uBCF4\uACE0\uC11C`,
-          `\uD3C9\uADE0 \uD48D\uBD80\uB3C4: ${result.avgRichness}%`,
-          `\uCD1D \uC5D4\uD130\uD2F0: ${result.entityCount}\uAC1C`,
-          ``,
-          `\u{1F7E2} \uC644\uC804 (\u226570%): ${result.breakdown?.complete || 0}\uAC1C`,
-          `\u{1F7E1} \uBD80\uBD84 (40-69%): ${result.breakdown?.partial || 0}\uAC1C`,
-          `\u{1F534} \uBBF8\uC785\uB825 (<40%): ${result.breakdown?.missing || 0}\uAC1C`
-        ];
-        if (result.suggestions && result.suggestions.length > 0) {
-          summary.push("", "\u{1F4A1} \uAC1C\uC120 \uC81C\uC548 (\uD48D\uBD80\uB3C4 \uB0AE\uC740 \uC21C):");
-          for (const s of result.suggestions.slice(0, 10)) {
-            summary.push(`  \u2022 ${s.entity} (${s.richness}%) \u2014 \uB204\uB77D: ${s.missing.join(", ")}`);
-          }
+  });
+  server.tool("check_metadata_quality", "\uD504\uB85C\uC81D\uD2B8\uC758 \uBA54\uD0C0\uB370\uC774\uD130 \uD48D\uBD80\uB3C4\uB97C \uBD84\uC11D\uD569\uB2C8\uB2E4. \uC124\uBA85, \uB3D9\uC758\uC5B4, \uC18D\uC131 \uC785\uB825\uB960\uC744 \uAE30\uBC18\uC73C\uB85C \uC804\uCCB4 \uD488\uC9C8 \uC810\uC218\uB97C \uC0B0\uCD9C\uD558\uACE0, \uAC1C\uC120\uC774 \uD544\uC694\uD55C \uC5D4\uD130\uD2F0 \uBAA9\uB85D\uC744 \uC81C\uC548\uD569\uB2C8\uB2E4.", {
+    projectId: external_exports.string().describe("\uD504\uB85C\uC81D\uD2B8 ID")
+  }, async ({ projectId }) => {
+    try {
+      const result = await client.checkMetadataQuality(projectId);
+      const summary = [
+        `\u{1F4CA} \uBA54\uD0C0\uB370\uC774\uD130 \uD488\uC9C8 \uBCF4\uACE0\uC11C`,
+        `\uD3C9\uADE0 \uD48D\uBD80\uB3C4: ${result.avgRichness}%`,
+        `\uCD1D \uC5D4\uD130\uD2F0: ${result.entityCount}\uAC1C`,
+        ``,
+        `\u{1F7E2} \uC644\uC804 (\u226570%): ${result.breakdown?.complete || 0}\uAC1C`,
+        `\u{1F7E1} \uBD80\uBD84 (40-69%): ${result.breakdown?.partial || 0}\uAC1C`,
+        `\u{1F534} \uBBF8\uC785\uB825 (<40%): ${result.breakdown?.missing || 0}\uAC1C`
+      ];
+      if (result.suggestions && result.suggestions.length > 0) {
+        summary.push("", "\u{1F4A1} \uAC1C\uC120 \uC81C\uC548 (\uD48D\uBD80\uB3C4 \uB0AE\uC740 \uC21C):");
+        for (const s of result.suggestions.slice(0, 10)) {
+          summary.push(`  \u2022 ${s.entity} (${s.richness}%) \u2014 \uB204\uB77D: ${s.missing.join(", ")}`);
         }
-        return {
-          content: [{
-            type: "text",
-            text: summary.join("\n")
-          }]
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: "text",
-            text: `Error: ${err instanceof Error ? err.message : String(err)}`
-          }],
-          isError: true
-        };
       }
+      return {
+        content: [{
+          type: "text",
+          text: summary.join("\n")
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text",
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`
+        }],
+        isError: true
+      };
     }
-  );
+  });
 }
 
-// src/client.ts
-var ThinkERDClient = class {
-  baseUrl;
-  headers;
-  constructor(apiUrl, token) {
-    this.baseUrl = apiUrl.replace(/\/+$/, "");
-    this.headers = {
-      "Authorization": `Bearer ${token}`,
-      "Content-Type": "application/json"
-    };
-  }
-  async request(path) {
-    const url = `${this.baseUrl}${path}`;
-    const res = await fetch(url, { headers: this.headers });
-    if (!res.ok) {
-      const body = await res.text().catch(() => "");
-      throw new Error(`ThinkERD API error ${res.status}: ${body || res.statusText}`);
-    }
-    const contentType = res.headers.get("content-type") || "";
-    if (contentType.includes("text/plain")) {
-      return res.text();
-    }
-    return res.json();
-  }
-  // ─── Diagrams ───
-  /** 사용자의 모든 다이어그램 목록 조회 */
-  async listDiagrams() {
-    return this.request("/api/mcp/diagrams");
-  }
-  /** 다이어그램 상세 (엔터티 + 관계 포함) */
-  async getDiagram(diagramId) {
-    return this.request(`/api/mcp/diagrams/${diagramId}`);
-  }
-  // ─── Entities ───
-  /** 단일 엔터티 상세 조회 */
-  async getEntity(diagramId, entityId) {
-    return this.request(`/api/mcp/diagrams/${diagramId}/entities/${entityId}`);
-  }
-  /** 엔터티 이름으로 검색 */
-  async searchEntities(diagramId, query) {
-    return this.request(
-      `/api/mcp/diagrams/${diagramId}/entities?q=${encodeURIComponent(query)}`
-    );
-  }
-  // ─── DDL ───
-  /** 다이어그램의 DDL 생성 */
-  async generateDDL(diagramId, dialect) {
-    const d = dialect ? `?dialect=${encodeURIComponent(dialect)}` : "";
-    return this.request(`/api/mcp/diagrams/${diagramId}/ddl${d}`);
-  }
-  // ─── Dictionary ───
-  /** 표준 사전 단어 목록 */
-  async getDictionary(projectId) {
-    return this.request(`/api/mcp/projects/${projectId}/dictionary`);
-  }
-  // ─── Drafts ───
-  /** 스키마 변경 제안 (Draft 생성) */
-  async proposeSchemaChange(diagramId, data) {
-    return this.postRequest(`/api/mcp/diagrams/${diagramId}/drafts`, data);
-  }
-  // ─── Sync / Push ───
-  async postRequest(path, body) {
-    const url = `${this.baseUrl}${path}`;
-    const res = await fetch(url, {
-      method: "POST",
-      headers: this.headers,
-      body: JSON.stringify(body)
-    });
-    if (!res.ok) {
-      const text = await res.text().catch(() => "");
-      throw new Error(`ThinkERD API error ${res.status}: ${text || res.statusText}`);
-    }
-    return res.json();
-  }
-  // ─── Context Provider (Project-level Ontology) ───
-  /** 자연어 질문 → 관련 엔터티 컨텍스트 (Graph RAG) */
-  async getProjectContext(projectId, question) {
-    return this.postRequest(`/api/mcp/projects/${projectId}/context`, { question });
-  }
-  /** 두 엔터티 간 JOIN 경로 탐색 */
-  async findJoinPath(projectId, from, to) {
-    return this.postRequest(`/api/mcp/projects/${projectId}/join-path`, { from, to });
-  }
-  /** 프로젝트 전체 스키마 요약 */
-  async getProjectSummary(projectId) {
-    return this.request(`/api/mcp/projects/${projectId}/summary`);
-  }
-  /** 메타데이터 풍부도 품질 보고 */
-  async checkMetadataQuality(projectId) {
-    return this.request(`/api/mcp/projects/${projectId}/quality`);
-  }
-  /** SPARQL 직접 실행 */
-  async queryOntology(projectId, query) {
-    return this.postRequest(`/api/ai/ontology/${projectId}/sparql`, { query });
-  }
-};
-
-// src/index.ts
-function parseArgs() {
-  const args = process.argv.slice(2);
-  let apiUrl = process.env.THINKERD_API_URL || "https://api.thinkerd.io";
-  let token = process.env.THINKERD_TOKEN || process.env.THINKERD_API_TOKEN || "";
-  let devMode = false;
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--api-url" && args[i + 1]) {
-      apiUrl = args[++i];
-    } else if (args[i] === "--token" && args[i + 1]) {
-      token = args[++i];
-    } else if (args[i] === "--dev") {
-      devMode = true;
-    }
-  }
-  if (devMode) {
-    apiUrl = process.env.THINKERD_API_URL || "http://localhost:8000";
+// ../cli/dist/commands/mcp.js
+var SERVER_DESCRIPTION = 'ThinkERD \u2014 \uC6F9 \uAE30\uBC18 ER \uB2E4\uC774\uC5B4\uADF8\uB7A8 \uBAA8\uB378\uB9C1 \uB3C4\uAD6C\uC758 MCP \uC11C\uBC84. \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC2A4\uD0A4\uB9C8 \uC124\uACC4(\uC5D4\uD130\uD2F0/\uCEEC\uB7FC/\uAD00\uACC4)\uB97C \uC870\uD68C\uD558\uACE0, DDL\uC744 \uC0DD\uC131\uD558\uBA70, \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD\uC744 \uC81C\uC548\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uD575\uC2EC \uAC1C\uB150: \uB2E4\uC774\uC5B4\uADF8\uB7A8(ERD \uBB38\uC11C), \uC5D4\uD130\uD2F0(\uD14C\uC774\uBE14, \uB17C\uB9AC\uBA85/\uBB3C\uB9AC\uBA85), \uCEEC\uB7FC(\uD0C0\uC785/PK/FK/Nullable), \uAD00\uACC4(1:1/1:N/M:N), \uC8FC\uC81C\uC601\uC5ED(\uC5C5\uBB34 \uB3C4\uBA54\uC778\uBCC4 \uBD84\uB958), \uD504\uB85C\uC81D\uD2B8(\uCD5C\uC0C1\uC704 \uB2E8\uC704), \uD45C\uC900\uC0AC\uC804(\uB17C\uB9AC\u2194\uBB3C\uB9AC \uB9E4\uD551). \uC0AC\uC6A9\uC790\uAC00 "\uC2A4\uD0A4\uB9C8/\uD14C\uC774\uBE14/ERD/\uC5D4\uD130\uD2F0/DDL"\uC744 \uC5B8\uAE09\uD558\uBA74 \uC774 \uC11C\uBC84\uC758 \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD558\uC138\uC694. \uCF54\uB4DC \uC0DD\uC131 \uC694\uCCAD \uC2DC \uBA3C\uC800 \uC2A4\uD0A4\uB9C8\uB97C \uC870\uD68C\uD55C \uD6C4 \uC0DD\uC131\uD558\uC138\uC694.';
+function findDevToken() {
+  let dir = dirname(fileURLToPath(import.meta.url));
+  for (let depth = 0; depth < 6; depth++) {
+    const candidate = resolve(dir, ".dev-mcp-token");
+    if (existsSync(candidate))
+      return readFileSync(candidate, "utf-8").trim();
+    dir = resolve(dir, "..");
+  }
+  return null;
+}
+async function mcpCommand(options) {
+  let apiUrl = options.apiUrl || process.env.THINKERD_API_URL || "https://api.thinkerd.io";
+  let token = options.token || process.env.THINKERD_TOKEN || process.env.THINKERD_API_TOKEN || "";
+  if (options.dev) {
+    apiUrl = options.apiUrl || process.env.THINKERD_API_URL || "http://localhost:8000";
     if (!token) {
-      let dir = __dirname;
-      for (let depth = 0; depth < 6; depth++) {
-        const tokenPath = resolve(dir, ".dev-mcp-token");
-        if (existsSync(tokenPath)) {
-          token = readFileSync(tokenPath, "utf-8").trim();
-          console.error(`[ThinkERD MCP] Dev mode \u2014 loaded PAT from ${tokenPath}`);
-          break;
-        }
-        dir = resolve(dir, "..");
+      const found = findDevToken();
+      if (!found) {
+        console.error("[ThinkERD MCP] Dev mode \u2014 .dev-mcp-token \uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.");
+        console.error("[ThinkERD MCP] \uBA3C\uC800 \uC11C\uBC84\uB97C \uB744\uC6B0\uC138\uC694: pnpm dev:server");
+        process.exit(1);
       }
+      token = found;
     }
-    if (!token) {
-      console.error(
-        "[ThinkERD MCP] Dev mode \u2014 .dev-mcp-token not found.\nStart the ThinkERD server first (pnpm dev:server) to auto-generate the token."
-      );
-      process.exit(1);
-    }
-    console.error("[ThinkERD MCP] Dev mode \u2014 connecting to " + apiUrl);
+    console.error(`[ThinkERD MCP] Dev mode \u2014 connecting to ${apiUrl}`);
   }
   if (!token) {
-    console.error(
-      "Error: ThinkERD API token is required.\nUsage: thinkerd-mcp --token <YOUR_PAT>\nOr set THINKERD_TOKEN environment variable.\nFor local development: thinkerd-mcp --dev"
-    );
+    console.error("Error: ThinkERD API token is required.");
+    console.error("Usage: thinkdata mcp --token <YOUR_PAT>");
+    console.error("Or set THINKERD_TOKEN environment variable.");
+    console.error("For local development: thinkdata mcp --dev");
     process.exit(1);
   }
-  return { apiUrl, token, devMode };
-}
-async function main() {
-  const { apiUrl, token } = parseArgs();
   const client = new ThinkERDClient(apiUrl, token);
   const server = new McpServer({
     name: "thinkerd",
     version: "0.1.0",
-    description: 'ThinkERD \u2014 \uC6F9 \uAE30\uBC18 ER \uB2E4\uC774\uC5B4\uADF8\uB7A8 \uBAA8\uB378\uB9C1 \uB3C4\uAD6C\uC758 MCP \uC11C\uBC84. \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC2A4\uD0A4\uB9C8 \uC124\uACC4(\uC5D4\uD130\uD2F0/\uCEEC\uB7FC/\uAD00\uACC4)\uB97C \uC870\uD68C\uD558\uACE0, DDL\uC744 \uC0DD\uC131\uD558\uBA70, \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD\uC744 \uC81C\uC548\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uD575\uC2EC \uAC1C\uB150: \uB2E4\uC774\uC5B4\uADF8\uB7A8(ERD \uBB38\uC11C), \uC5D4\uD130\uD2F0(\uD14C\uC774\uBE14, \uB17C\uB9AC\uBA85/\uBB3C\uB9AC\uBA85), \uCEEC\uB7FC(\uD0C0\uC785/PK/FK/Nullable), \uAD00\uACC4(1:1/1:N/M:N), \uC8FC\uC81C\uC601\uC5ED(\uC5C5\uBB34 \uB3C4\uBA54\uC778\uBCC4 \uBD84\uB958), \uD504\uB85C\uC81D\uD2B8(\uCD5C\uC0C1\uC704 \uB2E8\uC704), \uD45C\uC900\uC0AC\uC804(\uB17C\uB9AC\u2194\uBB3C\uB9AC \uB9E4\uD551). \uC0AC\uC6A9\uC790\uAC00 "\uC2A4\uD0A4\uB9C8/\uD14C\uC774\uBE14/ERD/\uC5D4\uD130\uD2F0/DDL"\uC744 \uC5B8\uAE09\uD558\uBA74 \uC774 \uC11C\uBC84\uC758 \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD558\uC138\uC694. \uCF54\uB4DC \uC0DD\uC131 \uC694\uCCAD \uC2DC \uBA3C\uC800 \uC2A4\uD0A4\uB9C8\uB97C \uC870\uD68C\uD55C \uD6C4 \uC0DD\uC131\uD558\uC138\uC694. \uBCC0\uACBD \uC81C\uC548\uC740 propose_schema_change\uB85C Draft \uC804\uC1A1 \u2192 \uC0AC\uC6A9\uC790 \uC2B9\uC778 \uD544\uC694.'
+    description: SERVER_DESCRIPTION
   });
   registerResources(server, client);
   registerTools(server, client);
@@ -22571,7 +22434,18 @@ async function main() {
   await server.connect(transport);
   console.error("[ThinkERD MCP] Server started. Connected via stdio.");
 }
-main().catch((err) => {
+
+// src/index.ts
+var argv = process.argv.slice(2);
+var read = (flag) => {
+  const i = argv.indexOf(flag);
+  return i >= 0 && argv[i + 1] ? argv[i + 1] : void 0;
+};
+mcpCommand({
+  apiUrl: read("--api-url"),
+  token: read("--token"),
+  dev: argv.includes("--dev")
+}).catch((err) => {
   console.error("[ThinkERD MCP] Fatal error:", err);
   process.exit(1);
 });