@axboot-mcp/mcp-server 1.0.0

package/CLAUDE.md

@@ -0,0 +1,119 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**mcp-axboot** is a Model Context Protocol (MCP) server that automatically generates Zustand store files from TypeScript interface definitions. It accelerates React/TypeScript development for Axboot projects by analyzing repository interfaces and generating standardized store code based on UI patterns.
+
+## Development Commands
+
+```bash
+# Build the project
+npm run build
+
+# Watch mode for development
+npm run dev
+
+# Start the MCP server (after build)
+npm run start
+
+# Clean build output
+npm run clean
+```
+
+## Architecture
+
+### MCP Server Structure
+
+The server uses the Model Context Protocol SDK with stdio transport. Entry point is `src/index.ts` which:
+1. Creates an MCP server instance
+2. Registers available tools via `ListToolsRequestSchema`
+3. Handles tool execution via `CallToolRequestSchema`
+
+### Tool Handlers (`src/handlers/`)
+
+| Handler | Purpose |
+|---------|---------|
+| `analyze.ts` | Parses TypeScript interfaces to extract methods and types |
+| `generate.ts` | Generates store files with explicit type selection |
+| `list-templates.ts` | Returns available store template information |
+| `analyze-requirements.ts` | NLP analysis of Korean requirements to extract features |
+| `generate-from-requirements.ts` | Auto-selects type and generates store |
+| `generate-multi-stores.ts` | Handles multi-list patterns (e.g., left/top/bottom lists) |
+
+### Template System (`src/templates/`)
+
+Templates are modular files (type1.ts through type11.ts) that generate Zustand store code. Note the numbering offset: template file `typeN.ts` corresponds to store type `N-1` (e.g., type6.ts → Type 5 store).
+
+Each template uses variable substitution via `TemplateVariables` interface for type-safe code generation.
+
+### Feature Definitions (`src/features/store-features.ts`)
+
+Central registry of store features (LIST, SEARCH, SAVE, DELETE, etc.) with:
+- Korean/English keywords for NLP matching
+- Associated states and actions
+- Type-to-feature mappings in `TYPE_FEATURES`
+
+### Store Type Mapping (10 Types)
+
+| Type | Template File | Pattern |
+|------|---------------|---------|
+| 1 | type1.ts | Basic List + Detail |
+| 2 | type2.ts | Master-Detail + Modal + Delete |
+| 3 | type3.ts | Tree-based |
+| 4 | type4.ts | Dashboard |
+| 5 | type6.ts | Simple List |
+| 6 | type7.ts | Reorderable List |
+| 7 | type8.ts | Master-Detail + Modal + Delete + Excel |
+| 8 | type9.ts | List + Selection + Excel |
+| 9 | type10.ts | Master-Detail + Modal + Detail API |
+| 10 | type11.ts | Master-Detail + Excel |
+
+## Natural Language Processing
+
+The requirement analyzer in `analyze-requirements.ts` matches Korean keywords to predefined features:
+
+| Keywords | Feature |
+|----------|---------|
+| 리스트, 목록, 조회 | LIST |
+| 검색, 찾기 | SEARCH |
+| 상세, 디테일 | DETAIL_PANEL |
+| 모달, 팝업 | MODAL |
+| 저장, 수정, 등록 | SAVE |
+| 삭제 | DELETE |
+| 엑셀, excel | EXCEL_DOWNLOAD |
+| 체크, checkbox | CHECKBOX |
+| 트리, 카테고리 | TREE |
+
+## Integration
+
+### Claude Desktop Configuration
+
+Server must be registered in Claude's config:
+
+```json
+{
+  "mcpServers": {
+    "mcp-axboot": {
+      "command": "node",
+      "args": ["/Users/kyle/Desktop/mcp-axboot/dist/index.js"]
+    }
+  }
+}
+```
+
+### Testing
+
+Use `test-server.js` for manual testing. The server communicates via stdio - no HTTP server is involved.
+
+## Language Context
+
+This project is primarily for Korean-speaking users (Axboot is a Korean framework). Natural language processing is Korean-focused, and most documentation is in Korean.
+
+## Type System Notes
+
+- TypeScript strict mode is enabled
+- Target: ES2020, Module: CommonJS
+- All template variables must be of type `TemplateVariables`
+- Template files use string substitution - ensure all variables are defined