@makitt.io/mds-mcp-server 0.1.1 → 0.1.3

package/README.md

@@ -1,9 +1,9 @@
 # @makitt.io/mds-mcp-server
 
 MCP (Model Context Protocol) server for `@makitt/mds`. AI 가 mds 의 catalog +
-playbook 을 자동 query — fabrication 0 의 최종 layer.
+playbook 을 자동 query — fabrication 0 보장의 최종 layer.
 
-> **Registry**: npmjs.org (표준 public npm registry). `.npmrc` 의 별도 setup 없이 install.
+> **Registry**: npmjs.org (표준 public npm registry). `.npmrc` 별도 setup 없이 install 가능.
 
 ## 무엇을 하는가
 
@@ -20,7 +20,7 @@ Claude Code / Cursor 같은 AI 도구가 다음을 자동 query:
 |---|---|
 | `mds_components_list` | 모든 mds 컴포넌트 list (layer 필터 가능) |
 | `mds_components_get` | 특정 컴포넌트의 full spec (props / types / JSDoc) |
-| `mds_components_search` | 컴포넌트 name / description / prop 의 text search |
+| `mds_components_search` | 컴포넌트 name / description / prop 에 대한 text search |
 | `mds_playbook_list` | 9 Playbook 영역 list |
 | `mds_playbook_get` | 특정 Playbook 의 full content (markdown) |
 | `mds_playbook_search` | 모든 Playbook 의 decision matrix / 안티패턴 text search |
@@ -85,7 +85,7 @@ pnpm build  # tsc + scripts/copy-data.mjs
 - `tsc` — TypeScript compile (`dist/index.js`)
 - `copy-data.mjs` — `../mds/dist/catalog.json` + `../mds/docs/playbook/` 을 `dist/data/` 로 복사
 
-→ self-contained package. `files: ["dist", "README.md"]` 가 npm publish 의 포함.
+→ self-contained package. `files: ["dist", "README.md"]` 가 npm publish 에 포함됨.
 
 ## Transport
 
@@ -93,11 +93,11 @@ stdio (Claude Code / Cursor 표준).
 
 ## Publish (maintainer 용)
 
-npm registry (`registry.npmjs.org`) 의 `@makitt.io/mds-mcp-server` 의 publish.
+npm registry (`registry.npmjs.org`) 에 `@makitt.io/mds-mcp-server` 를 publish.
 
 ### 첫 setup — Granular Access Token (공용 계정 권장)
 
-공용 npm 계정 (예: `techtaka-makitt`) 의 publish 의 자동 — 매번 2FA OTP race 의 안 적합. **Granular Access Token + bypass 2FA** 의 1회 setup + 이후 publish 자동.
+공용 npm 계정 (예: `techtaka-makitt`) publish 흐름을 자동화 — 매번 2FA OTP race 에는 부적합. **Granular Access Token + bypass 2FA** 를 1회 setup 하면 이후 publish 가 자동.
 
 1. **token 생성** — https://www.npmjs.com/settings/<username>/tokens/granular-access-tokens/new
    - **Token name**: `mds-mcp-server publish` (또는 유의미한 라벨)
@@ -106,14 +106,14 @@ npm registry (`registry.npmjs.org`) 의 `@makitt.io/mds-mcp-server` 의 publish.
    - **Packages and scopes**:
      - "Only select packages and scopes" → **`@makitt.io`** scope 추가
      - Permissions: **Read and write**
-   - **Bypass 2FA**: ✓ enable (publish 의 OTP 안 필요)
-   - Generate token → 값 복사 (한 번 만 표시)
-2. **token 의 공용 vault share** — 1Password / LastPass / Bitwarden 등 의 team 의 공유 entry. 채팅 / 코드 에 직접 X
-3. **각 maintainer 의 local setup** — `~/.npmrc` 의 직접 entry (또는 `npm config set`):
+   - **Bypass 2FA**: ✓ enable (publish 시 OTP 요구하지 않음)
+   - Generate token → 값 복사 (한 번만 표시)
+2. **token 을 공용 vault 에 share** — 1Password / LastPass / Bitwarden 등 team 공유 entry 에 보관. 채팅 / 코드에 직접 노출 금지
+3. **각 maintainer 의 local setup** — `~/.npmrc` 에 직접 entry 추가 (또는 `npm config set`):
    ```bash
    npm config set //registry.npmjs.org/:_authToken=<token>
    ```
-   → `~/.npmrc` 의 추가. git ignore 됨 (사용자 home dir).
+   → `~/.npmrc` 에 추가됨. git ignore 됨 (사용자 home dir).
 
 ### Publish 흐름
 
@@ -121,7 +121,7 @@ npm registry (`registry.npmjs.org`) 의 `@makitt.io/mds-mcp-server` 의 publish.
 cd packages/mds-mcp-server
 pnpm build                 # tsc + copy-data (catalog.json + playbook md → dist/data/)
 npm publish --dry-run      # tarball 검증 (file list / size / name / version)
-npm publish                # 실제 publish (bypass 2FA token 의 자동)
+npm publish                # 실제 publish (bypass 2FA token 으로 자동 처리)
 ```
 
 ### Version bump
@@ -136,14 +136,14 @@ npm version major   # 0.1.0 → 1.0.0 (breaking)
 
 ### 보안
 
-- ❌ token 의 채팅 / git 의 commit / chat log 등 의 leak — 즉시 npmjs.com 의 settings 의 **Revoke**
+- ❌ token 이 채팅 / git commit / chat log 등으로 leak 시 — 즉시 npmjs.com settings 에서 **Revoke**
 - ❌ 무한 expiration token — 1 year 이내
-- ❌ "Read and write" 의 모든 scope — `@makitt.io` 의 specific scope 만
-- ✓ Bypass 2FA 의 enable — 공용 계정 의 publish 의 OTP race 의 안
+- ❌ "Read and write" 모든 scope 허용 — `@makitt.io` specific scope 만 허용
+- ✓ Bypass 2FA enable — 공용 계정 publish 시 OTP race 방지
 
 ## 향후 (Step 6 follow-up)
 
 - `mds_lint_check(code)` — 사용자 코드의 mds rule 위반 자동 검출
-- `mds_skills_list` — AI fill 의 skill registry (ai-fill.md)
+- `mds_skills_list` — AI fill 용 skill registry (ai-fill.md)
 - `mds_responsive_check(component, viewport)` — 컴포넌트의 responsive 동작 spec
-- `mds_examples_get(component)` — 컴포넌트 사용 예 (story args + apps/web 의 실 사용 모음)
+- `mds_examples_get(component)` — 컴포넌트 사용 예 (story args + apps/web 실 사용 모음)