@maka/maka-cli 5.1.41 → 5.1.43

package/bundle/typescript/src/templates/react/kit/frames/workspace-manager.tsx

@@ -0,0 +1,166 @@
+import './<%= fileName %>.css';
+import * as React from 'react';
+import { Component } from 'react';
+import PropTypes from 'prop-types';
+import { WorkspaceManager, WorkspaceStore } from 'meteor/maka:maka-frames';
+
+interface <%= className %>Props {
+  currentWorkspaceId: string;
+  allWorkspaces: any[];
+  user?: any;
+  onWorkspaceSwitch?: (workspaceId: string) => void;
+}
+
+/**
+ * <%= className %> Component
+ *
+ * UI component for managing workspaces in the maka-frames package.
+ * Provides controls for creating, switching, renaming, and deleting workspaces.
+ */
+class <%= className %>Component extends Component<<%= className %>Props> {
+  static propTypes = {
+    currentWorkspaceId: PropTypes.string.isRequired,
+    allWorkspaces: PropTypes.array.isRequired,
+    user: PropTypes.object,
+    onWorkspaceSwitch: PropTypes.func
+  };
+
+  handleCreateWorkspace = () => {
+    const { user, onWorkspaceSwitch } = this.props;
+
+    const workspaceName = prompt('Enter workspace name:', `Workspace ${new Date().toLocaleTimeString()}`);
+    if (!workspaceName) return;
+
+    const workspaceId = `workspace-${Date.now()}`;
+    const workspaceData = {
+      id: workspaceId,
+      name: workspaceName,
+      frames: [],
+      createdAt: new Date(),
+      updatedAt: new Date()
+    };
+
+    // Use WorkspaceManager for logged-in users, WorkspaceStore for anonymous
+    if (user) {
+      WorkspaceManager.createWorkspace(workspaceData.id, workspaceData.name)
+        .then(() => {
+          console.log('Workspace created:', workspaceData.id);
+          if (onWorkspaceSwitch) onWorkspaceSwitch(workspaceData.id);
+        })
+        .catch((error: any) => {
+          console.error('Error creating workspace:', error);
+        });
+    } else {
+      WorkspaceStore.setWorkspace(workspaceData);
+      if (onWorkspaceSwitch) onWorkspaceSwitch(workspaceData.id);
+    }
+  }
+
+  handleDeleteWorkspace = (workspaceId: string) => {
+    const { user, allWorkspaces, onWorkspaceSwitch } = this.props;
+
+    const workspace = allWorkspaces.find(ws => ws.id === workspaceId);
+    if (!workspace) return;
+
+    const confirmed = confirm(`Are you sure you want to delete "${workspace.name}"?`);
+    if (!confirmed) return;
+
+    // Use WorkspaceManager for logged-in users, WorkspaceStore for anonymous
+    if (user) {
+      WorkspaceManager.deleteWorkspace(workspaceId)
+        .then(() => {
+          console.log('Workspace deleted:', workspaceId);
+          // Switch to first available workspace
+          const remainingWorkspaces = allWorkspaces.filter(ws => ws.id !== workspaceId);
+          if (remainingWorkspaces.length > 0 && onWorkspaceSwitch) {
+            onWorkspaceSwitch(remainingWorkspaces[0].id);
+          }
+        })
+        .catch((error: any) => {
+          // Handle error (e.g., last workspace can't be deleted)
+          alert(error.message || 'Cannot delete workspace');
+          console.error('Error deleting workspace:', error);
+        });
+    } else {
+      const success = WorkspaceStore.deleteWorkspace(workspaceId);
+      if (success) {
+        // Switch to first available workspace
+        const remainingWorkspaces = allWorkspaces.filter(ws => ws.id !== workspaceId);
+        if (remainingWorkspaces.length > 0 && onWorkspaceSwitch) {
+          onWorkspaceSwitch(remainingWorkspaces[0].id);
+        }
+      } else {
+        alert('Cannot delete the last workspace');
+      }
+    }
+  }
+
+  handleRenameWorkspace = (workspaceId: string) => {
+    const { user, allWorkspaces } = this.props;
+
+    const workspace = allWorkspaces.find(ws => ws.id === workspaceId);
+    if (!workspace) return;
+
+    const newName = prompt('Enter new workspace name:', workspace.name);
+    if (!newName || newName === workspace.name) return;
+
+    // Use WorkspaceManager for logged-in users, WorkspaceStore for anonymous
+    if (user) {
+      WorkspaceManager.updateWorkspace(workspaceId, { name: newName });
+    } else {
+      const localWorkspace = WorkspaceStore.getWorkspace(workspaceId);
+      if (localWorkspace) {
+        localWorkspace.name = newName;
+        localWorkspace.updatedAt = new Date();
+        WorkspaceStore.setWorkspace(localWorkspace);
+      }
+    }
+  }
+
+  render() {
+    const { currentWorkspaceId, allWorkspaces, onWorkspaceSwitch } = this.props;
+
+    return (
+      <div className="<%= fileName %>">
+        <div className="workspace-selector">
+          <select
+            value={currentWorkspaceId}
+            onChange={(e) => onWorkspaceSwitch && onWorkspaceSwitch(e.target.value)}
+            className="workspace-select"
+          >
+            {allWorkspaces.map(ws => (
+              <option key={ws.id} value={ws.id}>{ws.name}</option>
+            ))}
+          </select>
+        </div>
+
+        <div className="workspace-actions">
+          <button
+            onClick={this.handleCreateWorkspace}
+            className="workspace-btn workspace-create-btn"
+          >
+            + New Workspace
+          </button>
+
+          <button
+            onClick={() => this.handleRenameWorkspace(currentWorkspaceId)}
+            className="workspace-btn workspace-rename-btn"
+          >
+            Rename Workspace
+          </button>
+
+          {allWorkspaces.length > 1 && (
+            <button
+              onClick={() => this.handleDeleteWorkspace(currentWorkspaceId)}
+              className="workspace-btn workspace-delete-btn"
+            >
+              Delete Workspace
+            </button>
+          )}
+        </div>
+      </div>
+    );
+  }
+}
+
+export { <%= className %>Component };

package/bundle/typescript/src/templates/react/kit/mui/auth/login/basic-login-page.js.jsx

@@ -1,6 +1,8 @@
 import React, { useContext, useEffect } from 'react';
 import { Container, Paper, Typography, TextField, Button, Grid, Link } from '@mui/material';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router-dom';<% if (isSsr) { %>
+import { AuthContext } from '/imports/startup/lib/authentication-provider';<% } else { %>
+import { AuthContext } from '/imports/startup/client/authentication-provider';<% } %>
 
 export const BasicLoginPage = () => {
   const { currentUser, login } = useContext(AuthContext);

package/bundle/typescript/src/templates/react/kit/mui/auth/login/basic-login-page.js.tsx

@@ -1,6 +1,8 @@
 import React, { useContext, useEffect } from 'react';
 import { Container, Paper, Typography, TextField, Button, Grid, Link } from '@mui/material';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router-dom';<% if (isSsr) { %>
+import { AuthContext } from '/imports/startup/lib/authentication-provider';<% } else { %>
+import { AuthContext } from '/imports/startup/client/authentication-provider';<% } %>
 
 export const BasicLoginPage = () => {
   const { currentUser, login } = useContext(AuthContext);

package/bundle/typescript/src/templates/react/test/test.js.jsx

@@ -1,7 +1,7 @@
 import { render } from '@testing-library/react';
 <% if (test === 'mocha') { %>import { expect } from 'chai';<% } %>
 
-<% if(graphql === 'apollo') { %>
+<% if(clientGraphql === 'apollo') { %>
 import { MockedProvider } from '@apollo/react-testing';
 import gql from 'graphql-tag';
 const mocks = [
@@ -24,7 +24,7 @@ const { <%=className%>%> } = require('./<%= fileName %>');
 describe('<<%= className %>/>', function() {
 
  it('did render', () => {
- <%if(graphql === 'apollo') { %>
+ <%if(clientGraphql === 'apollo') { %>
    const <%=camelCaseName%> = render(
       <MockedProvider mocks={mocks} addTypename={false}>
        <<%= className %>/>

package/bundle/typescript/src/templates/react/test/test.js.tsx

@@ -1,7 +1,7 @@
 import { render } from '@testing-library/react';
 <% if (test === 'mocha') { %>import { expect } from 'chai';<% } %>
 
-<% if(graphql === 'apollo') { %>
+<% if(clientGraphql === 'apollo') { %>
 import { MockedProvider } from '@apollo/react-testing';
 import gql from 'graphql-tag';
 const mocks = [
@@ -24,7 +24,7 @@ const { <%=className%>%> } = require('./<%= fileName %>');
 describe('<<%= className %>/>', function() {
 
  it('did render', () => {
- <%if(graphql === 'apollo') { %>
+ <%if(clientGraphql === 'apollo') { %>
    const <%=camelCaseName%> = render(
       <MockedProvider mocks={mocks} addTypename={false}>
        <<%= className %>/>

package/bundle/typescript/src/tools/fsi/fsi.interfaces.d.ts

@@ -136,6 +136,8 @@ export declare enum CssEngines {
 }
 export declare enum ApiEngines {
     REST = "rest",
+    RPC = "rpc",
+    GRAPHQL = "graphql",
     NONE = "none"
 }
 export declare enum TestEngines {
@@ -164,6 +166,7 @@ export interface IEngines {
     js?: JsEngines;
     css?: CssEngines;
     api?: ApiEngines;
+    apis?: ApiEngines[];
     test?: TestEngines;
     client?: ClientEngines;
     graphql?: GraphqlEngines;

package/bundle/typescript/src/tools/fsi/fsi.interfaces.js

@@ -2,7 +2,7 @@ export const supportedEngines = {
     html: ['html'],
     js: ['js', 'jsx', 'ts', 'tsx'],
     css: ['css', 'less', 'scss', 'none'],
-    api: ['rest', 'none'],
+    api: ['rest', 'rpc', 'graphql', 'none'],
     test: ['jasmine', 'mocha', 'none'],
     client: ['react', 'vanilla'],
     graphql: ['apollo'],
@@ -31,6 +31,8 @@ export var CssEngines;
 export var ApiEngines;
 (function (ApiEngines) {
     ApiEngines["REST"] = "rest";
+    ApiEngines["RPC"] = "rpc";
+    ApiEngines["GRAPHQL"] = "graphql";
     ApiEngines["NONE"] = "none";
 })(ApiEngines || (ApiEngines = {}));
 export var TestEngines;

package/bundle/typescript/src/tools/fsi/fsi.interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"fsi.interfaces.js","sourceRoot":"","sources":["../../../../../src/tools/fsi/fsi.interfaces.ts"],"names":[],"mappings":"AAoIA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,6CAA6C;AAC7C,MAAM,CAAN,IAAY,WAEX;AAFD,WAAY,WAAW;IACrB,4BAAa,CAAA;AACf,CAAC,EAFW,WAAW,KAAX,WAAW,QAEtB;AAED,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,sBAAS,CAAA;IACT,wBAAW,CAAA;IACX,sBAAS,CAAA;IACT,wBAAW,CAAA;AACb,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAED,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,2BAAa,CAAA;AACf,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,2BAAa,CAAA;AACf,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB;AAED,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,4BAAa,CAAA;AACf,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,oCAAmB,CAAA;AACrB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,+BAAiB,CAAA;AACnB,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB;AAED,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB"}
+{"version":3,"file":"fsi.interfaces.js","sourceRoot":"","sources":["../../../../../src/tools/fsi/fsi.interfaces.ts"],"names":[],"mappings":"AAoIA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,6CAA6C;AAC7C,MAAM,CAAN,IAAY,WAEX;AAFD,WAAY,WAAW;IACrB,4BAAa,CAAA;AACf,CAAC,EAFW,WAAW,KAAX,WAAW,QAEtB;AAED,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,sBAAS,CAAA;IACT,wBAAW,CAAA;IACX,sBAAS,CAAA;IACT,wBAAW,CAAA;AACb,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAED,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,2BAAa,CAAA;AACf,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,iCAAmB,CAAA;IACnB,2BAAa,CAAA;AACf,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,4BAAa,CAAA;AACf,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,oCAAmB,CAAA;AACrB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,+BAAiB,CAAA;AACnB,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB;AAED,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB"}

package/docs/MCP_SERVER.md

@@ -0,0 +1,396 @@
+# Maka CLI MCP Server
+
+The Maka CLI includes an enhanced Model Context Protocol (MCP) server that exposes **all maka-cli capabilities** to AI agents like Claude. This allows AI assistants to discover, understand, and help you use any maka-cli command.
+
+## Quick Start
+
+Start the MCP server:
+
+```bash
+maka ai:mcp
+```
+
+The server starts on `http://localhost:3000` by default and automatically discovers all available maka-cli commands.
+
+## Options
+
+- `--port` - Port to listen on (default: 3000)
+- `--host` - Host to bind to (default: localhost)
+
+### Examples
+
+```bash
+# Start on default port
+maka ai:mcp
+
+# Custom port
+maka ai:mcp --port=8080
+
+# Bind to all network interfaces
+maka ai:mcp --host=0.0.0.0 --port=3001
+```
+
+## Server Features
+
+### Tools
+
+The MCP server provides these tools for AI agents:
+
+#### 1. `list-maka-commands`
+List all available Maka CLI commands with descriptions and usage.
+
+**Parameters:**
+- `filter` (optional): Filter commands by name or category (e.g., "aws", "generate", "deploy")
+
+**Example Usage:**
+```json
+{
+  "name": "list-maka-commands",
+  "arguments": {
+    "filter": "generate"
+  }
+}
+```
+
+#### 2. `get-command-info`
+Get detailed information about a specific command including usage, options, examples, and description.
+
+**Parameters:**
+- `command` (required): Command name (e.g., "create", "generate:component", "aws:create-instance")
+
+**Example Usage:**
+```json
+{
+  "name": "get-command-info",
+  "arguments": {
+    "command": "generate:component"
+  }
+}
+```
+
+#### 3. `execute-maka-command`
+Execute Maka CLI commands with safety restrictions to prevent destructive operations.
+
+**Parameters:**
+- `command` (required): Full command to execute (e.g., "maka --help")
+- `workingDirectory` (optional): Working directory for the command
+
+**Safety Features:**
+- Blocks destructive commands (murder, uninstall, rm, delete)
+- 30-second timeout
+- 10MB output buffer limit
+
+**Example Usage:**
+```json
+{
+  "name": "execute-maka-command",
+  "arguments": {
+    "command": "maka --help"
+  }
+}
+```
+
+#### 4. `get-project-info`
+Get information about the current Maka project including configuration.
+
+**Example Usage:**
+```json
+{
+  "name": "get-project-info",
+  "arguments": {}
+}
+```
+
+### Resources
+
+#### 1. `maka://commands/all`
+Complete reference of all Maka CLI commands in JSON format.
+
+**Format:**
+```json
+[
+  {
+    "name": "create",
+    "aliases": "None",
+    "shortDesc": "Create a new Meteor application",
+    "description": "...",
+    "usage": "maka create <app-name>",
+    "examples": ["maka create MyApp"],
+    "validOpts": ["..."],
+    "requiredOpts": [],
+    "experimental": false
+  }
+]
+```
+
+#### 2. `maka://project/config`
+Current project configuration and metadata.
+
+#### 3. `maka://info`
+Maka CLI version, platform, and system information.
+
+### Prompts
+
+Interactive conversation starters for common workflows:
+
+#### 1. `create-component`
+Component creation wizard with examples and best practices.
+
+**Parameters:**
+- `componentName` (required): Name of the component
+- `componentType` (optional): Type (component, page, layout, template)
+
+#### 2. `deploy-help`
+Deployment guide for different platforms and environments.
+
+**Parameters:**
+- `environment` (optional): Target environment (dev, staging, production)
+- `platform` (optional): Deployment platform (aws, docker, custom)
+
+#### 3. `project-setup`
+Interactive guide for setting up a new Maka project.
+
+**Parameters:**
+- `projectType` (optional): Project type (basic, full-stack, api)
+
+## Protocol
+
+The server implements the [Model Context Protocol](https://modelcontextprotocol.io) specification:
+
+- **Transport**: Streamable HTTP (stateless mode)
+- **Format**: Server-Sent Events (SSE)
+- **Message Protocol**: JSON-RPC 2.0
+- **Protocol Version**: 2024-11-05
+
+## Endpoints
+
+- `POST /mcp` - MCP protocol endpoint (Server-Sent Events)
+- `GET /health` - Health check endpoint
+
+## Testing
+
+### Health Check
+```bash
+curl http://localhost:3000/health
+```
+
+### List Available Tools
+```bash
+curl -X POST http://localhost:3000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 1,
+    "method": "tools/list",
+    "params": {}
+  }'
+```
+
+### Call a Tool
+```bash
+curl -X POST http://localhost:3000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 2,
+    "method": "tools/call",
+    "params": {
+      "name": "list-maka-commands",
+      "arguments": {
+        "filter": "aws"
+      }
+    }
+  }'
+```
+
+## Integrating with Claude Desktop
+
+Add this configuration to your Claude Desktop MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "maka-cli": {
+      "command": "maka",
+      "args": ["ai:mcp", "--port=3000"],
+      "transport": "http",
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+Alternatively, run the server manually and configure Claude Desktop to connect to the HTTP endpoint:
+
+```json
+{
+  "mcpServers": {
+    "maka-cli": {
+      "transport": "http",
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+## How It Works
+
+### Command Discovery
+
+The MCP server automatically discovers all commands by traversing the Maka CLI command tree:
+
+1. Starts at the root `Maka` command
+2. Recursively explores all subcommands
+3. Extracts metadata (name, description, usage, options, examples)
+4. Filters out internal/hidden commands
+5. Builds a complete command registry
+
+This means **any new command added to maka-cli is automatically exposed** through the MCP server.
+
+### Project Detection
+
+The server detects if you're in a Maka project by looking for `.maka/config.json`. Project-specific information is exposed through the `get-project-info` tool and `maka://project/config` resource.
+
+## Use Cases for AI Agents
+
+With this MCP server, AI agents like Claude can:
+
+1. **Discover Commands**: "What commands are available in maka-cli?"
+2. **Get Help**: "How do I create a new component?"
+3. **Learn Usage**: "Show me examples of the deploy command"
+4. **Execute Commands**: "Run maka --version for me"
+5. **Guide Workflows**: "Walk me through deploying to AWS"
+6. **Project Context**: "What's configured in my current project?"
+
+## Customization
+
+### Adding Custom Tools
+
+Edit `src/commands/ai/mcp.sub.cmd.ts` and add new tools:
+
+```typescript
+server.tool(
+  'my-custom-tool',
+  'Description of what my tool does',
+  {
+    param1: z.string().describe('Description of parameter')
+  },
+  async ({ param1 }) => {
+    // Your tool logic here
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Result: ${param1}`
+        }
+      ]
+    };
+  }
+);
+```
+
+### Adding Custom Resources
+
+```typescript
+server.resource(
+  'my-resource',
+  'maka://custom/resource',
+  {
+    mimeType: 'application/json',
+    description: 'My custom resource'
+  },
+  async () => {
+    return {
+      contents: [
+        {
+          uri: 'maka://custom/resource',
+          mimeType: 'application/json',
+          text: JSON.stringify({ data: 'value' }, null, 2)
+        }
+      ]
+    };
+  }
+);
+```
+
+### Adding Custom Prompts
+
+```typescript
+server.prompt(
+  'my-workflow',
+  'Guided workflow for a specific task',
+  {
+    taskType: z.enum(['option1', 'option2']).describe('Type of task')
+  },
+  async ({ taskType }) => {
+    return {
+      messages: [
+        {
+          role: 'user',
+          content: {
+            type: 'text',
+            text: `Help me with ${taskType}`
+          }
+        },
+        {
+          role: 'assistant',
+          content: {
+            type: 'text',
+            text: `Here's how to handle ${taskType}...`
+          }
+        }
+      ]
+    };
+  }
+);
+```
+
+## CORS Configuration
+
+The server is configured with CORS enabled for all origins by default. For production:
+
+```typescript
+app.use(cors({
+  origin: 'https://yourdomain.com', // Restrict to specific origin
+  exposedHeaders: ['Mcp-Session-Id']
+}));
+```
+
+## Dependencies
+
+- `@modelcontextprotocol/sdk` - MCP SDK
+- `express` - HTTP server
+- `cors` - CORS middleware
+- `zod` - Schema validation
+
+## Architecture
+
+```
+┌─────────────────┐
+│   AI Agent      │
+│  (e.g. Claude)  │
+└────────┬────────┘
+         │ MCP over HTTP
+         │
+┌────────▼────────┐
+│   MCP Server    │
+│  (ai:mcp cmd)   │
+├─────────────────┤
+│ • Tools         │
+│ • Resources     │
+│ • Prompts       │
+└────────┬────────┘
+         │
+         ├─► Command Discovery (Maka._commands)
+         ├─► Project Detection (.maka/config.json)
+         └─► Command Execution (execSync with safety)
+```
+
+## Resources
+
+- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
+- [MCP SDK on GitHub](https://github.com/modelcontextprotocol/typescript-sdk)
+- [Claude Desktop MCP Integration](https://docs.anthropic.com/claude/docs/model-context-protocol)
+- [Maka CLI Documentation](https://www.maka-cli.com)