[docs] add info on studio-mode mcp server

Author: NiloCK

packages/cli/CLAUDE.md

@@ -24,7 +24,9 @@ npx @vue-skuilder/cli pack my-course
 
 ### Project Initialization
 - **init**: Scaffolds new course project structure
+- **studio**: Launches complete editing environment with CouchDB, web UI, and MCP server
 - **pack**: Packages course content for distribution
+- **unpack**: Imports course content from CouchDB to static files
 
 ## Dependencies
 
@@ -49,12 +51,24 @@ npx @vue-skuilder/cli pack my-course
 - **Configuration**: Generates initial course configuration
 - **Dependencies**: Installs required npm packages
 
+### Studio Command (`commands/studio.ts`)
+- **Environment Setup**: Launches CouchDB, Express API, and web interface
+- **Data Loading**: Unpacks course data to temporary database
+- **MCP Server**: Provides Model Context Protocol server for Claude Code integration
+- **Configuration Display**: Shows MCP connection details and .mcp.json content
+
 ### Pack Command (`commands/pack.ts`)
 - **Course Compilation**: Bundles course content for distribution
 - **Static Data**: Converts dynamic course data to static format
 - **Optimization**: Minifies and optimizes course assets
 - **Packaging**: Creates deployable course bundle
 
+### MCP Server (`mcp-server.ts`)
+- **Protocol Implementation**: Full MCP server with 14 resources, 4 tools, 2 prompts
+- **Course Access**: Direct CourseDBInterface integration for real-time data
+- **Content Generation**: AI-powered card creation and content authoring
+- **ELO Integration**: Native support for difficulty rating system
+
 ## Utilities
 
 ### Template Management (`utils/template.ts`)
@@ -78,7 +92,8 @@ npx @vue-skuilder/cli pack my-course
 - **Binary Linking**: Automatically creates `skuilder` command alias
 
 ## Use Cases
-- **Course Authors**: Initialize new course projects
-- **Content Creators**: Package courses for distribution
+- **Course Authors**: Initialize new course projects with MCP server support
+- **Content Creators**: Package courses for distribution with AI-enabled authoring
 - **Developers**: Bootstrap vue-skuilder development environment
+- **Claude Code Users**: AI-enabled course content creation and editing via MCP
 - **Deployment**: Automated course packaging for CI/CD

packages/cli/README.md

@@ -96,6 +96,12 @@ Studio mode creates a full editing environment by starting multiple services:
    - Create/edit cards, manage tags, bulk import
    - Live preview of changes
 
+4. **MCP Server** (Course Content Agent)
+   - Model Context Protocol server for Claude Code integration
+   - AI-powered course content authoring and editing
+   - Direct access to course data, cards, tags, and ELO ratings
+   - Configuration for MCP clients is output at startup
+
 #### Studio Workflow
 
 1. **Load Course Data**: Unpacks your `public/static-courses/` JSON files into temporary CouchDB

packages/cli/src/utils/template.ts

@@ -590,9 +590,39 @@ When you run \`npm run studio\`, it will:
 1. Start a local CouchDB instance for temporary editing
 2. Load your course data from \`public/static-courses/\`
 3. Launch the studio interface at http://localhost:7174
-4. Save changes back to your static course files when you flush
+4. Provide MCP server connection for, eg, Claude Code integration
+5. Save changes back to your static course files when you flush
 
-**Important**: Studio mode **overwrites** existing static data source files in \`public/static-courses/\`. Make sure to commit or backup your course data before making major edits.`
+**Important**: Studio mode **overwrites** existing static data source files in \`public/static-courses/\`. Make sure to commit or backup your course data before making major edits.
+
+### Claude Code Integration (MCP Server)
+
+Studio mode automatically provides an MCP (Model Context Protocol) server for AI-powered course authoring with Claude Code. When you run \`npm run studio\`, it displays connection details like:
+
+\`\`\`bash
+🔗 MCP Server: node ./node_modules/@vue-skuilder/cli/dist/mcp-server.js course-id 5985
+📋 .mcp.json content:
+{
+  "mcpServers": {
+    "vue-skuilder-studio": {
+      "command": "./node_modules/@vue-skuilder/cli/dist/mcp-server.js",
+      "args": ["course-id", "5985"],
+      "env": {
+        "COUCHDB_SERVER_URL": "localhost:5985",
+        "COUCHDB_SERVER_PROTOCOL": "http",
+        "COUCHDB_USERNAME": "admin",
+        "COUCHDB_PASSWORD": "password"
+      }
+    }
+  }
+}
+\`\`\`
+
+Copy the generated \`.mcp.json\` content to your Claude Code configuration to enable:
+- **AI Content Creation**: Generate course cards with fill-in-the-blank and multiple-choice questions
+- **Smart Tagging**: Automatically tag cards and assign ELO difficulty ratings
+- **Course Analysis**: Analyze existing course content and suggest improvements
+- **Bulk Content Operations**: Create multiple cards at once with consistent formatting`
       : ''
   }