auigrid-mcp-server 0.3.1 → 0.3.3

package/README.md

@@ -8,6 +8,8 @@ AUIGrid 3.0.18부터 제공하며 npm 패키지 이름은 **`auigrid-mcp-server`
 
 이 패키지는 **AUIGrid 3.0.19** 문서와 예제를 포함합니다. 백분율 표시 및 편집 렌더러, 셀 범위 이동과 복사, 그룹 칼럼 숨김, 병합 헤더 이동 및 내보내기 레이아웃을 조회할 수 있습니다. 원격 서버의 자료 버전은 `list_versions`로 확인하십시오.
 
+**AUIGrid 3.0.18 사용자도 이용할 수 있습니다.** 조회 도구의 `version`에 `3.0.18` 또는 `3.0.18.1` 같은 패치 버전을 지정하면 현재 3.0.19 자료에서 기능별 지원 여부를 판정합니다. 신규 기능은 필요한 버전을 안내하며, 지원하는 기능의 상세 문서와 예제를 조회할 수 있습니다.
+
 ## 연결 방식
 
 원격 Streamable HTTP 연결(권장)과 로컬 npm 연결(stdio)을 제공합니다. 두 방식은 같은 다섯 조회 도구를 사용합니다.
@@ -134,6 +136,17 @@ Cursor의 MCP 설정 또는 VS Code의 `MCP: List Servers`에서 서버를 활
 
 > exportToXlsx와 useExportStyle 문서를 찾아 화면과 내보내기 스타일을 분리하는 예제를 작성해 줘.
 
+### React, Vue 및 TypeScript 사용 안내
+
+프레임워크별 생성 예제와 서브 컴포넌트 속성도 웹 개발 문서와 같은 원본으로 조회합니다. `search_docs`에서 `React TypeScript`, `Vue TypeScript`, `resizeMode`로 검색하거나 `get_api`에 다음 문서 ID를 전달하십시오.
+
+- `Desc/frameworks.html`: 파일 준비, 엔진과 래퍼 속성의 구분 및 버전 안내
+- `Desc/react.html`: React JavaScript/TypeScript 예제, ref와 이벤트 연결
+- `Desc/vue.html`: Vue 3 JavaScript/TypeScript 예제, 이벤트와 KeepAlive
+- `Desc/component-props.html`: 속성의 기본값과 래퍼별 지원 차이, 컨테이너 크기 감지
+
+본문에 `nextOffset`이 있으면 그 값을 `offset`에 넣어 이어서 조회합니다. `resizeMode="container"`는 **서브 컴포넌트 1.7**부터 제공하는 래퍼 옵션이며, 엔진 `gridProps` 또는 npm 타입 패키지의 속성이 아닙니다. MCP의 제품 `version`과 `since`만으로 래퍼 버전의 지원 여부를 판단하지 말고 본문의 지원 범위도 확인하십시오.
+
 ## 비상업용 버전의 CDN으로 빠르게 시작하기
 
 AUIGrid는 비상업용 버전의 CDN을 제공합니다. 정품은 CDN으로 제공하지 않습니다. 비상업용 목적의 `localhost` 또는 `127.0.0.1`에서 무료로 시작할 수 있습니다. MCP에 포함된 시작 안내와 HTML 예제를 사용하면 AI가 CDN을 연결하고 데이터를 넣어 실행 가능한 그리드를 작성할 수 있습니다.
@@ -155,14 +168,30 @@ localhost 이외의 도메인이나 IP에서 테스트하려면 [평가판 다
 
 | 도구 | 기능 |
 | --- | --- |
-| `list_versions` | 포함된 문서, 제품과 npm 타입 패키지의 버전 확인 |
+| `list_versions` | 포함된 문서/엔진, 조회 가능한 제품과 npm 타입 패키지의 버전 확인 |
 | `search_docs` | 한글 키워드 또는 API 이름으로 공식 문서 검색 |
-| `get_api` | 설명, 기본값, 도입 버전과 대응 TypeScript 선언 조회 |
+| `get_api` | 지원 여부 판정 후 설명, 기본값, 버전과 대응 TypeScript 선언 조회 |
 | `list_examples` | 기능, 프레임워크와 언어에 맞는 예제 검색 |
 | `get_example` | 실제 예제 코드와 관련 파일, 의존성 및 실행 조건 조회 |
 
 기본 그리드, 밴드형 레이아웃, 반응형 화면, 편집과 내보내기 예제를 제공합니다. JavaScript 기본 예제와 React, Vue의 JavaScript 및 TypeScript 예제 중 실제로 포함된 조합을 조회할 수 있습니다.
 
+### 3.0.18 제품에서 이용하기
+
+AI 도구에 사용 중인 제품 버전을 함께 알려 주십시오.
+
+> AUIGrid 3.0.18을 사용 중이야. MCP 조회에 version을 3.0.18로 지정하고, since가 3.0.19인 API는 제외해서 작성해줘.
+
+`search_docs`, `get_api`, `list_examples`, `get_example` 모두 같은 버전 지정 방식을 사용합니다. 현재 허용 제품은 `3.0.18`, `3.0.19`와 각 제품의 패치 버전이며, `list_versions`의 `acceptedProductVersions`와 `acceptsPatchVersions`에서 확인할 수 있습니다.
+
+응답의 `requestedVersion`은 요청한 제품 버전, `version`은 실제 자료 버전입니다. 예를 들어 `3.0.18`을 요청해도 `version`은 `3.0.19`이며 이전 제품에는 `compatibilityNote`를 함께 반환합니다. 과거 문서판을 제공하는 것은 아닙니다.
+
+MCP의 **`since`는 최초 제공 버전인 3.0.18부터 시작**합니다. 그 이전부터 있던 기능은 `since: "3.0.18"`, 3.0.19에서 추가한 기능은 `since: "3.0.19"`로 표시합니다. 공식 원본에 기록된 실제 API 도입 이력은 `introducedVersion`에 보존하며, 기록이 없으면 `null`입니다. 공식 HTML과 TypeScript의 기존 도입 버전은 바꾸지 않습니다.
+
+검색 결과와 예제 목록의 `available`은 요청한 제품이 해당 `since` 기준을 충족하는지 나타냅니다. `available: false`인 API 또는 예제를 상세 조회하면 **`isError: true`, `code: "VERSION_NOT_AVAILABLE"`**와 필요한 버전을 반환하며 상세 코드와 예제 파일은 제공하지 않습니다. 예를 들어 3.0.18에서 `PercentageRenderer`를 요청하면 3.0.19 이상이 필요하다는 안내를 받습니다. 렌더러 대표 문서, 대응 TypeScript 타입과 예제에 같은 기준을 적용합니다.
+
+`available: true`는 도입 기준 충족을 의미합니다. 기존 API의 기본값, 추가 옵션, 타입과 현재 예제의 동작까지 구버전과 같다고 보장하지 않으므로 사용 중인 제품 문서와 확인하십시오.
+
 ## 자료와 업데이트
 
 MCP는 패키지에 포함된 공식 문서와 예제를 읽습니다. 그리드 실행 엔진이나 고객 데이터에 접근하지 않으며, 코드 작성과 수정은 연결한 AI 도구가 수행합니다. 예제를 실행할 때는 AUIGrid 엔진, 라이선스 및 CSS가 필요합니다. 비상업용 로컬 예제는 CDN으로 연결하거나 GitHub에서 내려받아 사용하며, 상용 환경에서는 해당 환경에 맞는 제품 배포본과 라이선스를 사용합니다.