@thinkdata/cli 0.2.2 → 0.3.0

package/README.md

@@ -0,0 +1,119 @@
+# @thinkdata/cli
+
+> ThinkERD CLI — 데이터베이스 스키마를 ERD로 가져오고, AI 에이전트에 연결한다
+
+하나의 도구에 네 가지 모드가 있습니다.
+
+| 명령 | 하는 일 |
+|---|---|
+| `mcp` | **MCP 서버**로 동작 — Claude Code·Cursor 등이 ERD를 조회 |
+| `extract` | DB 스키마를 뽑아 **ERD에 반영** |
+| `compare` | DB와 ERD 모델의 **차이 비교** |
+| `serve` | 브라우저(ThinkERD 웹)용 로컬 에이전트 |
+
+`mcp`와 `extract`가 짝입니다 — **읽기**는 MCP로, **쓰기**는 extract로. 둘이 같은
+패키지에 있어 설치가 한 번이면 끝납니다.
+
+## 사전 준비
+
+ThinkERD 앱 메뉴 → **Settings → Developer & API** 에서 Personal Access Token(PAT)을
+발급합니다. Pro 이상 플랜에서 가능하며, 스키마를 반영하려면 `write` 스코프가 필요합니다.
+
+스코프는 **필요한 만큼만** 주십시오. 워크스페이스를 지정해 발급하면 그 밖의 리소스는
+조회되지 않습니다.
+
+## MCP 연결
+
+`.mcp.json`(Claude Code) 또는 각 IDE의 설정 파일에 넣습니다.
+
+```json
+{
+  "mcpServers": {
+    "thinkerd": {
+      "command": "npx",
+      "args": ["-y", "@thinkdata/cli", "mcp", "--api-url", "https://api.thinkerd.io"]
+    }
+  }
+}
+```
+
+| IDE | 설정 파일 |
+|---|---|
+| Claude Code | 레포 루트 `.mcp.json` (또는 `claude mcp add`) |
+| Cursor | `~/.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+
+> ⚠️ **Claude Code의 `.mcp.json`은 대개 커밋됩니다.** 위 예시가 `--token`을 빼고 있는
+> 이유입니다 — 토큰은 `THINKERD_TOKEN` 환경변수로 넘기십시오. 설정 파일에 평문으로
+> 적으면 저장소 이력에 남습니다.
+>
+> Claude Code는 Claude Desktop의 설정 파일을 **읽지 않습니다.** 이름이 비슷해
+> 그쪽 경로를 따라가는 경우가 있는데, JSON 형식은 같아도 파일이 다릅니다.
+
+종전의 `@thinkdata/mcp-server` 도 계속 동작합니다(별칭). 다만 그쪽은 MCP만 있고
+`extract`가 없어, 새로 설정한다면 이 패키지를 쓰는 편이 낫습니다.
+
+## 스키마를 ERD에 반영
+
+```bash
+npx @thinkdata/cli extract "postgresql://user:pass@host:5432/db" \
+    --diagram <다이어그램ID> --pat thkd_...
+```
+
+**병합입니다.** 캔버스 좌표·색·주제영역은 보존하고 컬럼과 관계만 갱신합니다.
+DB에서 사라진 엔터티는 지우지 않고 세어서 알려 줍니다 — 설계 중인 테이블이 ERD에
+먼저 그려져 있을 수 있기 때문입니다.
+
+**다이어그램 ID 찾는 곳**: 탐색기에서 다이어그램 우클릭 → **Properties** →
+Identification Information → ID (복사 아이콘). 주소창에는 나오지 않습니다.
+
+`--diagram` 없이 실행하면 브라우저가 폴링해 가는 종전 경로로 동작합니다.
+
+### 마이그레이션 훅에 붙이기
+
+스키마가 바뀔 때마다 ERD가 따라오게 하려면 마이그레이션 뒤에 겁니다.
+
+```json
+{
+  "scripts": {
+    "db:migrate": "drizzle-kit migrate && npm run erd:sync",
+    "erd:sync": "thinkdata extract $DATABASE_URL --diagram $THINKERD_DIAGRAM_ID --pat $THINKERD_PAT"
+  }
+}
+```
+
+## DB 드라이버는 선택 설치입니다
+
+`pg`·`mysql2`·`oracledb`·`mssql` 은 `optionalDependencies` 이고 **실제로 그 DB에
+접속할 때만** 로드됩니다. MCP만 쓰는 경우 드라이버가 없어도 됩니다.
+
+설치되지 않은 드라이버를 쓰려 하면 무엇을 깔아야 하는지 알려 줍니다.
+
+## 명령 목록
+
+```
+thinkdata mcp        [--api-url <url>] [--token <pat>] [--dev]
+thinkdata extract    <connection-string> [--diagram <id>] [--pat <token>] [--schema <name>]
+thinkdata compare    <connection-string> [--project <id>] [--pat <token>]
+thinkdata serve      [--port 3100]
+thinkdata login      [token]
+thinkdata whoami
+```
+
+## 환경변수
+
+| 변수 | 설명 | 기본값 |
+|---|---|---|
+| `THINKERD_API_URL` | ThinkERD API URL | `https://api.thinkerd.io` |
+| `THINKERD_TOKEN` | Personal Access Token | — |
+
+## 보안
+
+- 토큰은 SHA-256 해시로만 서버에 저장됩니다
+- 워크스페이스/프로젝트 단위로 접근 범위를 제한할 수 있습니다
+- 토큰 만료일을 설정할 수 있습니다 (기본 90일)
+
+## 라이선스
+
+MIT

package/dist/bin/thinkdata.js

@@ -13,6 +13,7 @@ import { extractCommand } from '../commands/extract.js';
 import { compareCommand } from '../commands/compare.js';
 import { serveCommand } from '../commands/serve.js';
 import { loginCommand, whoamiCommand } from '../commands/auth.js';
+import { mcpCommand } from '../commands/mcp.js';
 const program = new Command();
 program
     .name('thinkdata')
@@ -32,6 +33,7 @@ program
     .option('--ssl', 'Enable SSL connection')
     .option('--token <token>', 'ThinkERD transfer token (one-time)')
     .option('--pat <pat>', 'Personal Access Token for automation (thkd_...)')
+    .option('--diagram <id>', 'Apply directly to this ThinkERD diagram (no browser; requires --pat)')
     .option('-o, --output <file>', 'Save to JSON file instead of sending')
     .option('-i, --interactive', 'Interactive wizard mode')
     .action(extractCommand);
@@ -51,6 +53,16 @@ program
     .option('-p, --port <port>', 'Port number (default: 3100)', parseInt)
     .action(serveCommand);
 // ── auth 명령 ──
+// ── mcp 명령 ──
+// stdio 트랜스포트라 stdout 은 프로토콜 채널이다. 이 명령의 안내는 전부 stderr 로 나간다.
+program
+    .command('mcp')
+    .description('Run the MCP server over stdio (for Claude Code, Cursor, Windsurf, ...)')
+    .option('--api-url <url>', 'ThinkERD API URL')
+    .option('--token <pat>', 'Personal Access Token (or set THINKERD_TOKEN)')
+    .option('--dev', 'Local development — read the token the server wrote to .dev-mcp-token')
+    .action(mcpCommand);
+// ── auth 명령 ──
 program
     .command('login [token]')
     .description('Login to ThinkERD using a Personal Access Token')

package/dist/bin/thinkdata.js.map

@@ -1 +1 @@
-{"version":3,"file":"thinkdata.js","sourceRoot":"","sources":["../../src/bin/thinkdata.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,wEAAwE,CAAC;KACrF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,mBAAmB;AACnB,OAAO;KACF,OAAO,CAAC,6BAA6B,CAAC;KACtC,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;KAC1D,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC5C,MAAM,CAAC,mBAAmB,EAAE,eAAe,EAAE,QAAQ,CAAC;KACtD,MAAM,CAAC,qBAAqB,EAAE,eAAe,CAAC;KAC9C,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC5C,MAAM,CAAC,yBAAyB,EAAE,8CAA8C,CAAC;KACjF,MAAM,CAAC,uBAAuB,EAAE,iCAAiC,CAAC;KAClE,MAAM,CAAC,OAAO,EAAE,uBAAuB,CAAC;KACxC,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KAC/D,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;KACxE,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;KACrE,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;KACtD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5B,mBAAmB;AACnB,OAAO;KACF,OAAO,CAAC,6BAA6B,CAAC;KACtC,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KAC/D,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;KACxE,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;KAC/C,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,CAAC;KACjE,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5B,4BAA4B;AAC5B,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0EAA0E,CAAC;KACvF,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,QAAQ,CAAC;KACpE,MAAM,CAAC,YAAY,CAAC,CAAC;AAE1B,gBAAgB;AAChB,OAAO;KACF,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,YAAY,CAAC,CAAC;AAE1B,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,aAAa,CAAC,CAAC;AAE3B,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"thinkdata.js","sourceRoot":"","sources":["../../src/bin/thinkdata.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,wEAAwE,CAAC;KACrF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,mBAAmB;AACnB,OAAO;KACF,OAAO,CAAC,6BAA6B,CAAC;KACtC,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;KAC1D,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC5C,MAAM,CAAC,mBAAmB,EAAE,eAAe,EAAE,QAAQ,CAAC;KACtD,MAAM,CAAC,qBAAqB,EAAE,eAAe,CAAC;KAC9C,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC5C,MAAM,CAAC,yBAAyB,EAAE,8CAA8C,CAAC;KACjF,MAAM,CAAC,uBAAuB,EAAE,iCAAiC,CAAC;KAClE,MAAM,CAAC,OAAO,EAAE,uBAAuB,CAAC;KACxC,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KAC/D,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;KACxE,MAAM,CAAC,gBAAgB,EAAE,sEAAsE,CAAC;KAChG,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;KACrE,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;KACtD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5B,mBAAmB;AACnB,OAAO;KACF,OAAO,CAAC,6BAA6B,CAAC;KACtC,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KAC/D,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC;KACxE,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;KAC/C,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,CAAC;KACjE,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5B,4BAA4B;AAC5B,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0EAA0E,CAAC;KACvF,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,QAAQ,CAAC;KACpE,MAAM,CAAC,YAAY,CAAC,CAAC;AAE1B,gBAAgB;AAChB,eAAe;AACf,8DAA8D;AAC9D,OAAO;KACF,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,wEAAwE,CAAC;KACrF,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,eAAe,EAAE,+CAA+C,CAAC;KACxE,MAAM,CAAC,OAAO,EAAE,uEAAuE,CAAC;KACxF,MAAM,CAAC,UAAU,CAAC,CAAC;AAExB,gBAAgB;AAChB,OAAO;KACF,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,YAAY,CAAC,CAAC;AAE1B,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,aAAa,CAAC,CAAC;AAE3B,OAAO,CAAC,KAAK,EAAE,CAAC"}