@kiyeonjeon21/datacontext 0.2.0 → 0.3.1

package/docs/MCP_TEST_GUIDE.md

@@ -0,0 +1,414 @@
+# MCP 도구 테스트 가이드
+
+Cursor에서 DataContext MCP 도구를 테스트하는 방법입니다.
+
+## 1. Cursor MCP 설정
+
+### 방법 1: 로컬 빌드 사용 (개발 중)
+
+1. Cursor 설정 열기: `Cmd + ,` → `MCP`
+2. 다음 설정 추가:
+
+```json
+{
+  "mcpServers": {
+    "datacontext": {
+      "command": "node",
+      "args": [
+        "/Users/kiyeonjeon/Projects/business/DataContext-HQ/datacontext-cli/dist/cli/index.js",
+        "connect",
+        "sqlite:./test-mcp.db"
+      ],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-api03-..."
+      }
+    }
+  }
+}
+```
+
+### 방법 2: npm 패키지 사용 (배포 후)
+
+```json
+{
+  "mcpServers": {
+    "datacontext": {
+      "command": "npx",
+      "args": [
+        "@kiyeonjeon21/datacontext",
+        "connect",
+        "sqlite:./test-mcp.db"
+      ]
+    }
+  }
+}
+```
+
+## 2. Cursor 재시작
+
+설정 변경 후 Cursor를 재시작하세요.
+
+## 3. 빠른 시작: 자연어 질의 예시
+
+Cursor 채팅에서 아래와 같이 자연어로 질문하면 Cursor가 자동으로 적절한 MCP 도구를 호출합니다:
+
+| 질문 | 호출되는 도구 |
+|------|-------------|
+| "비즈니스 용어 목록을 보여줘" | `list_terms()` |
+| "'활성' 관련 용어를 찾아줘" | `search_terms()` |
+| "활성 사용자 중 최근 주문한 VIP 고객 조회해줘" | `enhance_query()` → SQL 생성 |
+| "신규 가입자 = 7일 이내 용어 추가해줘" | `generate_glossary()` |
+| "데이터베이스 테이블 목록을 보여줘" | `list_tables()` |
+| "users 테이블 구조를 설명해줘" | `describe_table()` |
+| "활성 사용자 5명을 조회해줘" | `query()` |
+
+**💡 Tip:** 자연어로 질문하면 Cursor가 자동으로 적절한 도구를 선택합니다. 직접 도구를 호출할 수도 있습니다.
+
+## 4. MCP 도구 상세 테스트
+
+Cursor 채팅에서 자연어로 질문하면 Cursor가 자동으로 적절한 MCP 도구를 호출합니다.
+
+### 4.1 용어 목록 조회
+
+**자연어 질의:**
+```
+"데이터베이스에 정의된 비즈니스 용어 목록을 보여줘"
+"glossary에 있는 모든 용어를 나열해줘"
+"정의된 business terms를 확인하고 싶어"
+```
+
+**또는 직접 호출:**
+```
+list_terms()
+```
+
+**예상 결과:**
+- 모든 business terms 목록 반환
+- 각 용어의 term, definition, sqlExpression 포함
+
+---
+
+### 4.2 용어 검색
+
+**자연어 질의:**
+```
+"'활성'이라는 키워드로 용어를 검색해줘"
+"active user 관련 용어를 찾아줘"
+"활성 사용자에 대한 비즈니스 용어가 있나?"
+```
+
+**또는 직접 호출:**
+```
+search_terms({ query: "활성" })
+```
+
+**예상 결과:**
+- "활성 사용자" 용어 매칭
+- SQL 조건 제안
+
+---
+
+### 4.3 Query Enhancement (핵심 기능!)
+
+**자연어 질의:**
+```
+"활성 사용자 중 최근 주문한 VIP 고객을 조회하는 쿼리를 만들어줘"
+"활성 사용자 중 최근 주문한 VIP 고객 조회해줘"
+"이 쿼리를 개선해줘: 활성 사용자 중 최근 주문한 VIP 고객"
+```
+
+**또는 직접 호출:**
+```
+enhance_query({ query: "활성 사용자 중 최근 주문한 VIP 고객" })
+```
+
+**예상 결과:**
+```json
+{
+  "success": true,
+  "query": "활성 사용자 중 최근 주문한 VIP 고객",
+  "usedTerms": ["활성 사용자", "최근 주문", "VIP 고객"],
+  "suggestedConditions": [
+    "status = 1",
+    "created_at >= DATE_SUB(NOW(), INTERVAL 30 DAY)",
+    "COUNT(order_id) >= 10"
+  ],
+  "method": "local"
+}
+```
+
+**Cursor가 자동으로:**
+- 용어를 매칭하고 SQL 조건을 추출
+- 해당 조건을 포함한 SQL 쿼리 생성
+
+---
+
+### 4.4 AI 용어 생성 (API 키 필요)
+
+**자연어 질의:**
+```
+"다음 용어들을 비즈니스 용어집에 추가해줘: 신규 가입자 = 7일 이내, 프리미엄 회원 = 구독료 10000원 이상"
+"AI로 용어를 생성해줘: 신규 가입자 = 7일 이내 가입한 사용자, 프리미엄 회원 = 구독료 10000원 이상인 회원"
+"이 용어들을 glossary에 추가해줘: 신규 가입자 = 7일 이내, 프리미엄 회원 = 구독료 10000원 이상"
+```
+
+**또는 직접 호출:**
+```
+generate_glossary({ 
+  terms: "신규 가입자 = 7일 이내, 프리미엄 회원 = 구독료 10000원 이상" 
+})
+```
+
+**예상 결과:**
+- 2개 용어 생성
+- SQL 표현식, 동의어, 카테고리 자동 생성
+
+---
+
+### 4.5 수동 용어 추가
+
+**자연어 질의:**
+```
+"'테스트 용어'라는 비즈니스 용어를 추가해줘. 정의는 '테스트용 정의'이고 SQL은 'test = 1'이야"
+"새로운 용어를 추가하고 싶어: 용어는 '테스트 용어', 정의는 '테스트용 정의', SQL은 'test = 1'"
+```
+
+**또는 직접 호출:**
+```
+add_term({
+  term: "테스트 용어",
+  definition: "테스트용 정의",
+  sqlExpression: "test = 1",
+  synonyms: ["test term"],
+  appliesTo: { tables: ["users"] },
+  category: "custom"
+})
+```
+
+---
+
+### 4.6 테이블 목록 조회
+
+**자연어 질의:**
+```
+"데이터베이스에 있는 모든 테이블 목록을 보여줘"
+"어떤 테이블들이 있나?"
+"스키마의 테이블 목록을 확인하고 싶어"
+```
+
+**또는 직접 호출:**
+```
+list_tables({ schema: "main" })
+```
+
+---
+
+### 4.7 테이블 상세 정보
+
+**자연어 질의:**
+```
+"users 테이블의 구조를 설명해줘"
+"users 테이블에 어떤 컬럼들이 있나?"
+"users 테이블의 상세 정보를 보여줘"
+```
+
+**또는 직접 호출:**
+```
+describe_table({ table: "users", schema: "main" })
+```
+
+---
+
+### 4.8 쿼리 실행
+
+**자연어 질의:**
+```
+"SELECT * FROM users WHERE status = 1 LIMIT 5 이 쿼리를 실행해줘"
+"활성 사용자 5명을 조회해줘"
+"status가 1인 사용자 5명을 보여줘"
+```
+
+**또는 직접 호출:**
+```
+query({ 
+  sql: "SELECT * FROM users WHERE status = 1 LIMIT 5" 
+})
+```
+
+## 5. 통합 테스트 시나리오
+
+### 시나리오 1: 자연어 쿼리 → SQL 생성 (End-to-End)
+
+**전제 조건:** 용어가 이미 정의되어 있어야 합니다.
+- 활성 사용자: `status = 1`
+- 최근 주문: `created_at >= DATE_SUB(NOW(), INTERVAL 30 DAY)`
+- VIP 고객: `COUNT(order_id) >= 10`
+
+**1단계: 자연어 질의**
+```
+"활성 사용자 중 최근 주문한 VIP 고객 조회해줘"
+```
+
+**2단계: Cursor가 자동으로 수행**
+- `enhance_query` 도구 호출
+- 용어 매칭 ("활성 사용자", "최근 주문", "VIP 고객")
+- SQL 조건 추출
+- SQL 쿼리 생성
+
+**3단계: 생성된 SQL**
+```sql
+SELECT u.* FROM users u
+JOIN orders o ON o.user_id = u.id
+WHERE u.status = 1  -- 활성 사용자 (from glossary)
+AND o.created_at >= DATE_SUB(NOW(), INTERVAL 30 DAY)  -- 최근 주문 (from glossary)
+GROUP BY u.id
+HAVING COUNT(o.id) >= 10  -- VIP 고객 (from glossary)
+```
+
+---
+
+### 시나리오 2: 용어 정의 → 쿼리 생성 (전체 플로우)
+
+**1단계: 용어 정의**
+```
+"다음 용어들을 비즈니스 용어집에 추가해줘:
+- 활성 사용자 = status가 1인 사용자
+- 최근 주문 = 30일 이내 주문
+- VIP 고객 = 주문 10건 이상"
+```
+
+**2단계: 용어 확인**
+```
+"정의한 용어 목록을 보여줘"
+```
+
+**3단계: 자연어 쿼리**
+```
+"활성 사용자 중 최근 주문한 VIP 고객을 조회하는 SQL을 만들어줘"
+```
+
+**4단계: 쿼리 실행**
+```
+"위에서 만든 쿼리를 실행해줘"
+```
+
+---
+
+### 시나리오 3: 용어 검색 → 쿼리 개선
+
+**1단계: 용어 검색**
+```
+"'활성' 관련 용어를 찾아줘"
+```
+
+**2단계: 검색 결과 확인 후 쿼리 개선**
+```
+"활성 사용자만 조회하는 쿼리를 만들어줘"
+```
+
+**3단계: Cursor가 자동으로**
+- 검색된 용어의 SQL 조건 적용
+- 올바른 WHERE 절 생성
+
+---
+
+### 시나리오 4: 테이블 구조 확인 → 용어 정의 → 쿼리 생성
+
+**1단계: 테이블 구조 확인**
+```
+"users 테이블 구조를 보여줘"
+```
+
+**2단계: 용어 정의**
+```
+"users 테이블에서 status = 1인 사용자를 '활성 사용자'로 정의해줘"
+```
+
+**3단계: 쿼리 생성**
+```
+"활성 사용자 목록을 조회해줘"
+```
+
+## 6. VS Code Extension 테스트 (Cursor에서도 동일)
+
+Cursor는 VS Code 기반이므로 VS Code Extension을 그대로 사용할 수 있습니다.
+
+### 5.1 Extension 설치
+
+```bash
+code --install-extension kiyeonjeon21.vscode-datacontext
+```
+
+또는 Cursor Extensions에서 "DataContext" 검색
+
+### 5.2 Extension 사용
+
+1. **REST API 서버 시작** (다른 터미널)
+   ```bash
+   npx @kiyeonjeon21/datacontext serve sqlite:./test-mcp.db --port 3000
+   ```
+
+2. **Cursor에서 연결**
+   - `Cmd+Shift+P` → "DataContext: Connect to Database"
+   - URL: `http://localhost:3000`
+
+3. **Knowledge 패널 확인**
+   - 왼쪽 사이드바에서 DataContext 아이콘 클릭
+   - "Business Glossary" 카테고리 확인
+   - 용어 목록 표시 확인
+
+4. **명령어 테스트**
+   - `Cmd+Shift+P` → "DataContext: Add Business Term"
+   - `Cmd+Shift+P` → "DataContext: Generate Glossary with AI"
+   - `Cmd+Shift+P` → "DataContext: Search Terms"
+
+## 7. 문제 해결
+
+### MCP 서버 연결 실패
+
+1. Cursor 재시작
+2. 설정 파일 경로 확인
+3. `node` 또는 `npx` 경로 확인
+4. 데이터베이스 연결 문자열 확인
+
+### 도구가 보이지 않음
+
+1. Cursor 채팅에서 MCP 도구 목록 확인
+2. 서버 로그 확인 (Cursor 개발자 도구)
+3. 설정 파일 JSON 문법 확인
+
+### API 키 오류
+
+- `ANTHROPIC_API_KEY` 환경 변수 확인
+- `.env` 파일이 MCP 서버에서 읽히지 않을 수 있음
+- Cursor 설정에서 직접 `env`에 추가
+
+## 8. 체크리스트
+
+### MCP 도구 테스트
+
+- [ ] Cursor MCP 설정 완료
+- [ ] Cursor 재시작
+- [ ] **용어 목록 조회**: "비즈니스 용어 목록을 보여줘"
+- [ ] **용어 검색**: "'활성' 관련 용어를 찾아줘"
+- [ ] **Query Enhancement**: "활성 사용자 중 최근 주문한 VIP 고객 조회해줘"
+- [ ] **AI 용어 생성**: "신규 가입자 = 7일 이내, 프리미엄 회원 = 구독료 10000원 이상 용어 추가해줘" (API 키 필요)
+- [ ] **테이블 목록**: "데이터베이스 테이블 목록을 보여줘"
+- [ ] **테이블 상세**: "users 테이블 구조를 설명해줘"
+- [ ] **쿼리 실행**: "활성 사용자 5명을 조회해줘"
+
+### VS Code Extension 테스트
+
+- [ ] VS Code Extension 설치
+- [ ] Extension에서 Glossary UI 확인
+- [ ] "DataContext: Add Business Term" 명령어 테스트
+- [ ] "DataContext: Generate Glossary with AI" 명령어 테스트
+- [ ] "DataContext: Search Terms" 명령어 테스트
+
+### 통합 시나리오 테스트
+
+- [ ] 시나리오 1: 자연어 쿼리 → SQL 생성
+- [ ] 시나리오 2: 용어 정의 → 쿼리 생성
+- [ ] 시나리오 3: 용어 검색 → 쿼리 개선
+- [ ] 시나리오 4: 테이블 구조 확인 → 용어 정의 → 쿼리 생성
+

package/docs/SYNC_GUIDE.md

@@ -0,0 +1,242 @@
+# DataContext Sync Guide
+
+> 이 문서는 AI 코드 어시스턴트가 DataContext 프로젝트의 여러 컴포넌트 간 동기화를 유지하는 데 필요한 정보를 제공합니다.
+
+## 프로젝트 구조 개요
+
+```
+DataContext-HQ/
+├── datacontext-cli/     # CLI + MCP Server + REST API
+├── vscode-datacontext/  # VS Code Extension
+└── datacontext/         # Business docs, landing page
+```
+
+---
+
+## 동기화 규칙
+
+### 1. REST API ↔ VS Code Extension 동기화
+
+**원칙:** CLI의 REST API 엔드포인트가 추가/변경되면, VS Code Extension도 업데이트해야 합니다.
+
+#### 체크리스트
+
+| CLI 변경 (`datacontext-cli`) | Extension 변경 (`vscode-datacontext`) |
+|------------------------------|---------------------------------------|
+| `src/api/server.ts`에 새 엔드포인트 추가 | `src/services/connectionManager.ts`에 메서드 추가 |
+| `docs/API.md` 업데이트 | `README.md` API Endpoints 섹션 업데이트 |
+| 새 기능/tool 추가 | `package.json` commands 추가 |
+| — | `src/extension.ts`에 명령어 핸들러 추가 |
+
+#### API 매핑 테이블
+
+이 테이블은 CLI API와 Extension 메서드 간의 매핑을 보여줍니다:
+
+| REST API Endpoint | HTTP Method | Extension Method | 상태 |
+|-------------------|-------------|------------------|------|
+| `/health` | GET | `connect()` 내부 체크 | ✅ |
+| `/api/tables` | GET | `getTables()` | ✅ |
+| `/api/tables/:name` | GET | `getTables()` 내부 | ✅ |
+| `/api/tables/:name/description` | PUT | `setTableDescription()` | ✅ |
+| `/api/tables/:table/columns/:column/description` | PUT | `setColumnDescription()` | ✅ |
+| `/api/query` | POST | `SQLExecutor.execute()` | ✅ |
+| `/api/query/estimate` | POST | `SQLExecutor.estimateCost()` | ✅ |
+| `/api/harvest` | POST | `harvest()` | ✅ |
+| `/api/knowledge` | GET | `getKnowledge()` | ✅ |
+| `/api/feedback` | POST | `recordFeedback()` | ✅ |
+| `/api/metrics` | GET | `getMetrics()` | ✅ |
+| `/api/examples` | POST | `addQueryExample()` | ✅ |
+| `/api/rules` | POST | `addBusinessRule()` | ✅ |
+| `/api/rules/candidates` | GET | `getRuleCandidates()` | ✅ |
+| `/api/context` | POST | (미구현 - 선택적) | ⚠️ |
+| `/api/schema` | GET | (미구현 - 선택적) | ⚠️ |
+| `/api/harvest/preview` | GET | (미구현 - 선택적) | ⚠️ |
+
+---
+
+### 2. MCP Tools ↔ REST API 동기화
+
+**원칙:** MCP tool과 REST API는 동일한 `DataContextService`를 사용합니다. 새 기능은 두 곳 모두에 노출되어야 합니다.
+
+#### 파일 매핑
+
+| 기능 추가 시 | MCP 파일 | REST 파일 |
+|-------------|----------|----------|
+| 새 tool/endpoint | `src/mcp/tools.ts` | `src/api/server.ts` |
+| 새 service 메서드 | `src/core/context-service.ts` | `src/core/context-service.ts` |
+
+#### MCP Tools ↔ REST Endpoints 매핑
+
+| MCP Tool | REST Endpoint | Service Method |
+|----------|---------------|----------------|
+| `query` | `POST /api/query` | `service.query()` |
+| `list_tables` | `GET /api/tables` | `service.listTables()` |
+| `describe_table` | `GET /api/tables/:name` | `service.getTableWithContext()` |
+| `get_context` | `POST /api/context` | `service.buildContext()` |
+| `add_description` | `PUT /api/tables/:name/description` | `service.setTableDescription()` |
+| `harvest_metadata` | `POST /api/harvest` | `service.harvest()` |
+| `estimate_cost` | `POST /api/query/estimate` | `service.estimateCost()` |
+| `record_feedback` | `POST /api/feedback` | `service.recordFeedback()` |
+| `get_metrics` | `GET /api/metrics` | `service.getMetricsSummary()` |
+| `add_query_example` | `POST /api/examples` | `service.addQueryExample()` |
+| `add_business_rule` | `POST /api/rules` | `service.addBusinessRule()` |
+
+---
+
+### 3. 문서 동기화
+
+**원칙:** 코드 변경 시 관련 문서도 함께 업데이트합니다.
+
+| 변경 유형 | 업데이트 필요 문서 |
+|----------|-------------------|
+| 새 CLI command | `datacontext-cli/README.md` |
+| 새 REST endpoint | `datacontext-cli/docs/API.md` |
+| 새 MCP tool | `datacontext-cli/README.md` MCP Tools 테이블 |
+| 새 Extension command | `vscode-datacontext/README.md` Commands 테이블 |
+| Extension 설정 추가 | `vscode-datacontext/README.md` Configuration 섹션 |
+| 데모 시나리오 변경 | `datacontext-cli/docs/DEMO_SCRIPT.md` |
+
+---
+
+## 버전 관리
+
+### 버전 위치
+
+| 컴포넌트 | 파일 | 필드 |
+|----------|------|------|
+| CLI | `datacontext-cli/package.json` | `"version"` |
+| Extension | `vscode-datacontext/package.json` | `"version"` |
+
+### 버전 증가 규칙
+
+- **Patch (0.0.X)**: 버그 수정, 문서 업데이트
+- **Minor (0.X.0)**: 새 기능 추가 (하위 호환)
+- **Major (X.0.0)**: Breaking changes
+
+### CHANGELOG 업데이트
+
+각 릴리스에서 다음 파일 업데이트:
+- `datacontext-cli/CHANGELOG.md`
+- `vscode-datacontext/CHANGELOG.md`
+
+---
+
+## 타입 동기화
+
+### CLI 타입 → Extension 타입
+
+CLI에서 정의된 타입이 Extension에서도 필요할 때, 동일한 구조로 재정의합니다.
+
+#### 예시: QueryFeedback 타입
+
+**CLI (`src/core/feedback-manager.ts`):**
+```typescript
+export interface QueryFeedback {
+  originalSql: string;
+  correctedSql?: string;
+  intent?: string;
+  feedbackType: 'success' | 'corrected' | 'failed' | 'rejected';
+  tables?: string[];
+  // ...
+}
+```
+
+**Extension (`src/services/connectionManager.ts`):**
+```typescript
+export interface QueryFeedback {
+  originalSql: string;
+  correctedSql?: string;
+  intent?: string;
+  feedbackType: 'success' | 'corrected' | 'failed' | 'rejected';
+  tables?: string[];
+  errorMessage?: string;
+}
+```
+
+**주의:** Extension은 API Response 기준으로 타입을 정의합니다. CLI 내부 타입과 100% 일치할 필요 없음.
+
+---
+
+## 자동 동기화 체크리스트
+
+AI 어시스턴트가 코드 변경 시 확인해야 할 사항:
+
+### REST API 엔드포인트 추가 시
+- [ ] `src/api/server.ts`에 라우트 추가
+- [ ] `docs/API.md`에 문서 추가
+- [ ] `vscode-datacontext/src/services/connectionManager.ts`에 메서드 추가
+- [ ] `vscode-datacontext/README.md` API Endpoints 섹션 업데이트
+
+### MCP Tool 추가 시
+- [ ] `src/mcp/tools.ts`의 `getMcpTools()` 에 추가
+- [ ] `src/mcp/tools.ts`의 `handleToolCall()` switch에 핸들러 추가
+- [ ] `README.md` MCP Tools 테이블 업데이트
+
+### Extension Command 추가 시
+- [ ] `package.json` contributes.commands에 추가
+- [ ] `src/extension.ts`에 핸들러 등록
+- [ ] `README.md` Commands 테이블 업데이트
+- [ ] 필요 시 `package.json` keybindings/menus 추가
+
+### 새 설정 옵션 추가 시
+- [ ] `package.json` contributes.configuration에 추가
+- [ ] `README.md` Configuration 섹션 업데이트
+
+---
+
+## 테스트 동기화
+
+| 기능 영역 | 테스트 파일 |
+|----------|------------|
+| Knowledge Store | `tests/knowledge-store.test.ts` |
+| MCP Tools | `tests/mcp-tools.test.ts` |
+| PostgreSQL Adapter | `tests/postgres-adapter.test.ts` |
+| SQLite Adapter | `tests/sqlite-adapter.test.ts` |
+| Safety Validator | `tests/safety-validator.test.ts` |
+
+새 기능 추가 시 관련 테스트도 추가해야 합니다.
+
+---
+
+## 참고: 의존성 관계
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    vscode-datacontext                       │
+│  (VS Code Extension - UI Layer)                             │
+└─────────────────────────┬───────────────────────────────────┘
+                          │ HTTP (REST API)
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    datacontext-cli                          │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │
+│  │  api/       │  │  mcp/       │  │  cli/       │          │
+│  │  (REST)     │  │  (MCP)      │  │  (Terminal) │          │
+│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘          │
+│         │                │                │                 │
+│         └────────────────┼────────────────┘                 │
+│                          ▼                                  │
+│  ┌─────────────────────────────────────────────────────┐    │
+│  │                    core/                            │    │
+│  │  (DataContextService - platform-agnostic)           │    │
+│  └─────────────────────────┬───────────────────────────┘    │
+│                            │                                │
+│  ┌───────────┬─────────────┼─────────────┬───────────┐      │
+│  ▼           ▼             ▼             ▼           ▼      │
+│ adapters/ knowledge/    safety/      schema/   feedback/    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**핵심 원칙:**
+- `core/`는 platform-agnostic - `mcp/`, `api/`를 import하지 않음
+- `mcp/`와 `api/`는 서로를 import하지 않음 - 둘 다 `core/`만 사용
+- Extension은 REST API만 사용 - CLI 코드 직접 import 불가
+
+---
+
+## 변경 이력
+
+| 날짜 | 변경 내용 |
+|------|----------|
+| 2026-01-01 | 초기 문서 작성 |
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiyeonjeon21/datacontext",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "AI-native database context layer - Make AI understand your data better",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,6 +11,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "serve": "node dist/api/start-server.js",
     "lint": "eslint src --ext .ts",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -42,10 +43,12 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.2",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "better-sqlite3": "^12.5.0",
     "commander": "^12.1.0",
     "cors": "^2.8.5",
+    "dotenv": "^17.2.3",
     "express": "^5.2.1",
     "mysql2": "^3.16.0",
     "pg": "^8.13.0",