@thinkdata/mcp-server 0.2.0 → 0.3.0

package/package.json

@@ -1,52 +1,50 @@
 {
-    "name": "@thinkdata/mcp-server",
-    "version": "0.2.0",
-    "description": "ThinkERD MCP Server — AI agents can query your database schema",
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "bin": {
-        "thinkerd-mcp": "./dist/index.js"
-    },
-    "files": [
-        "dist",
-        "README.md"
-    ],
-    "publishConfig": {
-        "access": "public"
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/Thinkdata-dev/thinkdata",
-        "directory": "packages/mcp-server"
-    },
-    "homepage": "https://thinkdata.dev",
-    "scripts": {
-        "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --banner:js=\"import{createRequire as __cr}from'module';import{fileURLToPath as __f}from'url';import{dirname as __d}from'path';const require=__cr(import.meta.url);const __filename=__f(import.meta.url);const __dirname=__d(__filename);\" && tsc --emitDeclarationOnly",
-        "dev": "tsx src/index.ts",
-        "typecheck": "tsc --noEmit",
-        "prepublishOnly": "npm run build",
-        "smoke": "node scripts/smoke.mjs",
-        "test": "vitest run"
-    },
-    "keywords": [
-        "mcp",
-        "model-context-protocol",
-        "erd",
-        "database",
-        "schema",
-        "thinkerd"
-    ],
-    "license": "MIT",
-    "dependencies": {},
-    "devDependencies": {
-        "@types/node": "^20.14.0",
-        "esbuild": "^0.28.0",
-        "tsx": "^4.19.0",
-        "typescript": "^5.4.5",
-        "@modelcontextprotocol/sdk": "^1.12.1",
-        "zod": "^3.23.8",
-        "@thinkdata/semantic-core": "workspace:*",
-        "vitest": "^3.2.4"
-    }
+  "name": "@thinkdata/mcp-server",
+  "version": "0.3.0",
+  "description": "ThinkERD MCP Server — AI agents can query your database schema",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "thinkerd-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Thinkdata-dev/thinkdata",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://thinkdata.dev",
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --banner:js=\"import{createRequire as __cr}from'module';import{fileURLToPath as __f}from'url';import{dirname as __d}from'path';const require=__cr(import.meta.url);const __filename=__f(import.meta.url);const __dirname=__d(__filename);\" && tsc --emitDeclarationOnly",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "smoke": "node scripts/smoke.mjs",
+    "test": "echo \"계약 테스트는 @thinkdata/cli 로 이관됨 (src/mcp/__tests__)\" && exit 0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "erd",
+    "database",
+    "schema",
+    "thinkerd"
+  ],
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.4.5",
+    "vitest": "^3.2.4",
+    "@thinkdata/cli": "workspace:*"
+  }
 }

package/dist/client.d.ts

@@ -1,104 +0,0 @@
-/**
- * ThinkERD API Client
- *
- * MCP Server가 ThinkERD 클라우드 API와 통신하기 위한 HTTP 클라이언트입니다.
- * PAT(Personal Access Token) 기반 인증을 사용합니다.
- *
- * @module client
- */
-export interface DiagramSummary {
-    id: string;
-    name: string;
-    projectId: string;
-    projectName?: string;
-    entityCount: number;
-    relationshipCount: number;
-    updatedAt: string;
-}
-export interface EntityDetail {
-    id: string;
-    name: string;
-    tableName: string;
-    logicalName?: string;
-    entityRole?: string;
-    columns: ColumnDetail[];
-}
-export interface ColumnDetail {
-    id: string;
-    name: string;
-    logicalName?: string;
-    type: string;
-    isPrimaryKey?: boolean;
-    isForeignKey?: boolean;
-    isNullable?: boolean;
-    defaultValue?: string;
-    description?: string;
-}
-export interface RelationshipDetail {
-    id: string;
-    sourceEntityId: string;
-    sourceEntityName: string;
-    targetEntityId: string;
-    targetEntityName: string;
-    type: string;
-    sourceCardinality: string;
-    targetCardinality: string;
-}
-export interface DictionaryWord {
-    id: string;
-    logicalName: string;
-    physicalName: string;
-    /**
-     * 사내에서 이 단어를 부르는 다른 말.
-     *
-     * 사용자가 가장 많이 채우는 필드인데 온톨로지 `skos:altLabel`에는 실리지 않으므로,
-     * **이 창구가 사내 표준 어휘가 외부 AI에 닿는 유일한 경로다.**
-     */
-    synonyms?: string[];
-    /** `'classifier'` | `'modifier'` — 컬럼이 아니라 `word_type`의 값이다 */
-    classifier?: string;
-}
-export declare class ThinkERDClient {
-    private readonly baseUrl;
-    private readonly headers;
-    constructor(apiUrl: string, token: string);
-    private request;
-    /** 사용자의 모든 다이어그램 목록 조회 */
-    listDiagrams(): Promise<DiagramSummary[]>;
-    /** 다이어그램 상세 (엔터티 + 관계 포함) */
-    getDiagram(diagramId: string): Promise<{
-        diagram: DiagramSummary;
-        entities: EntityDetail[];
-        relationships: RelationshipDetail[];
-    }>;
-    /** 단일 엔터티 상세 조회 */
-    getEntity(diagramId: string, entityId: string): Promise<EntityDetail>;
-    /** 엔터티 이름으로 검색 */
-    searchEntities(diagramId: string, query: string): Promise<EntityDetail[]>;
-    /** 다이어그램의 DDL 생성 */
-    generateDDL(diagramId: string, dialect?: string): Promise<string>;
-    /** 표준 사전 단어 목록 */
-    getDictionary(projectId: string): Promise<DictionaryWord[]>;
-    /** 스키마 변경 제안 (Draft 생성) */
-    proposeSchemaChange(diagramId: string, data: {
-        entityName: string;
-        changeType: string;
-        changeData: Record<string, unknown>;
-        reason: string;
-    }): Promise<{
-        draft_id: string;
-        status: string;
-    }>;
-    private postRequest;
-    /** 자연어 질문 → 관련 엔터티 컨텍스트 (Graph RAG) */
-    getProjectContext(projectId: string, question: string): Promise<any>;
-    /** 두 엔터티 간 JOIN 경로 탐색 */
-    findJoinPath(projectId: string, from: string, to: string): Promise<any>;
-    /** 프로젝트 전체 스키마 요약 */
-    getProjectSummary(projectId: string): Promise<any>;
-    /** 메타데이터 풍부도 품질 보고 */
-    checkMetadataQuality(projectId: string): Promise<any>;
-    /** SPARQL 직접 실행 */
-    queryOntology(projectId: string, query: string): Promise<any>;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -1,12 +0,0 @@
-/**
- * MCP Resources 등록
- *
- * Resources는 읽기 전용 데이터를 노출합니다.
- * AI 에이전트가 ThinkERD의 스키마 정보를 컨텍스트로 가져갈 수 있습니다.
- *
- * @module resources
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ThinkERDClient } from './client.js';
-export declare function registerResources(server: McpServer, client: ThinkERDClient): void;
-//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAgJjF"}

package/dist/toolManifest.d.ts

@@ -1,20 +0,0 @@
-/**
- * 배송되는 도구 목록의 **정본**.
- *
- * ## 왜 목록을 따로 적는가
- *
- * 2026-08-29 점검에서 **레포에 18종, npm에 5종**이 있는 것이 발견됐다. 13종은 한
- * 번도 배송된 적이 없었다. 원인은 배포 자동화가 태그를 밀 때만 도는데 **태그 미는
- * 것을 잊은 것**이고, 더 근본적으로는 "레포에 있는 것"과 "실제로 나간 것"을
- * **아무도 대조하지 않은 것**이다.
- *
- * 그래서 대조를 사람이 아니라 테스트가 한다. 도구를 추가·삭제하면 이 파일도 같이
- * 고쳐야 하고, 안 고치면 `toolContract.test.ts`가 실패한다.
- *
- * `@thinkdata/governance-types`의 `copilot-actions.ts`가 액션 프로토콜에 대해
- * 하는 역할과 같다 (CLAUDE.md §4.5).
- */
-/** 등록되는 도구 이름 — `registerTools`와 정확히 일치해야 한다 */
-export declare const TOOL_MANIFEST: readonly ["get_entity", "search_entities", "generate_ddl", "validate_schema", "harvest_schema_semantics", "propose_schema_change", "get_business_dictionary", "analyze_legacy_sql", "semantic_search", "get_business_context", "generate_sql", "get_project_context", "find_join_path", "get_project_summary", "query_ontology", "check_metadata_quality"];
-export type ToolName = (typeof TOOL_MANIFEST)[number];
-//# sourceMappingURL=toolManifest.d.ts.map

package/dist/toolManifest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toolManifest.d.ts","sourceRoot":"","sources":["../src/toolManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gDAAgD;AAChD,eAAO,MAAM,aAAa,4VAmBhB,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/tools.d.ts

@@ -1,4 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ThinkERDClient } from './client.js';
-export declare function registerTools(server: McpServer, client: ThinkERDClient): void;
-//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA0vB7E"}