mcp-task-server 0.2.0 → 0.2.2

package/README.md

@@ -2,21 +2,46 @@
 
 A Model Context Protocol (MCP) server for task management with multi-agent coordination. Designed for use with Cursor IDE and other MCP-compatible AI tools.
 
+```mermaid
+flowchart TB
+    subgraph Cursor IDE
+        A[AI Assistant]
+    end
+    
+    subgraph MCP Task Server
+        B[21 Tools]
+        C[Preferences Engine]
+    end
+    
+    subgraph Your Machine
+        D[~/.cursor/shared-context.json]
+        E[memory_bank/tasks/]
+        F[memory_bank/execution/progress.md]
+    end
+    
+    A <-->|MCP Protocol| B
+    B --> C
+    C -->|read/write| D
+    B -->|read/write| E
+    B -->|auto-sync| F
+    D -->|inject into responses| A
+```
+
 ## Features
 
-- **Task Management**: Create, update, complete, and track tasks
+- **22 MCP Tools**: Comprehensive task management and coordination
 - **Multi-Agent Coordination**: Support for Planner, Worker, and Judge roles
 - **Dependency Tracking**: Tasks can depend on other tasks
 - **Priority Levels**: Critical, High, Medium, Low
 - **Scalable Storage**: Individual task files with JSON registry and markdown summary
 - **Prompt-Based Operations**: PRD parsing, task expansion, complexity analysis
 - **Shared Context**: Reads user preferences from `~/.cursor/shared-context.json` to personalise prompts
-- **Project Initialization**: Scaffolds agent-kit, memory_bank, and cursor rules
+- **Project Initialisation**: Scaffolds 22 template files across agent-kit, memory_bank (architecture, context, execution, reference), and cursor rules
 
 ## Quick Start
 
 ```bash
-# Add to a new project and initialize
+# Add to a new project and initialise
 init_project({ project_name: "my-app" })
 
 # Add your first task
@@ -26,9 +51,50 @@ add_task({ title: "Set up development environment" })
 next_task()
 ```
 
-## Shared Context
+## Shared Context & Preferences
+
+The server reads `~/.cursor/shared-context.json` for user preferences and automatically injects them into tool responses and prompts.
+
+### How Preferences Flow
+
+```mermaid
+flowchart LR
+    A[~/.cursor/shared-context.json] -->|read at runtime| B[MCP Task Server]
+    B -->|inject into| C[Tool Responses]
+    B -->|inject into| D[Generated Prompts]
+    C -->|AI sees| E[preferences hint]
+    D -->|AI uses| F[full context]
+```
+
+### Memory Storage Architecture
+
+```mermaid
+flowchart TB
+    subgraph Your Machine
+        A[shared-context.json]
+    end
+    
+    subgraph MCP Server
+        B[show_memory] -->|read| A
+        C[update_memory] -->|write| A
+        D[Tool Responses] -->|include hint from| A
+    end
+    
+    subgraph AI Assistant
+        E[Sees preferences in responses]
+        F[Applies to content creation]
+    end
+    
+    D --> E --> F
+```
+
+### Where Preferences Are Used
 
-The server reads `~/.cursor/shared-context.json` for user preferences (writing style, identity, workflow) and includes them in generated prompts. This bridges the gap between Cursor's memory system and isolated MCP servers.
+| Tool Type | How Preferences Are Applied |
+|-----------|----------------------------|
+| `list_tasks`, `get_task`, `add_task`, `update_task`, `next_task` | Brief hint in response |
+| `parse_prd`, `expand_task`, `research_task` | Full context in generated prompt |
+| `check_compliance` | All preferences for validation |
 
 ### Compliance Checking
 
@@ -172,7 +238,7 @@ Human-readable detailed task files for each top-level task:
 # Status: done
 # Dependencies: None
 # Priority: high
-# Description: Initialize the project with required tooling.
+# Description: Initialise the project with required tooling.
 # Details:
 Full implementation details here...
 
@@ -200,17 +266,17 @@ This architecture scales well for complex projects with many tasks and subtasks.
 
 ## Tools
 
-### Project Initialization
+### Project Initialisation
 
 | Tool | Description |
 |------|-------------|
-| `init_project` | Initialize project with agent-kit, memory_bank, and cursor rules |
+| `init_project` | Initialise project with agent-kit, memory_bank, and cursor rules |
 
 ```typescript
-// Initialize with auto-detected project name
+// Initialise with auto-detected project name
 init_project()
 
-// Initialize with custom name
+// Initialise with custom name
 init_project({ project_name: "my-app" })
 
 // Force overwrite existing files
@@ -219,14 +285,14 @@ init_project({ force: true })
 
 ### Core Tools
 
-| Tool | Description |
-|------|-------------|
-| `list_tasks` | List all tasks, optionally filtered by status or assignee |
-| `get_task` | Get a specific task by ID with subtasks |
-| `add_task` | Create a new task |
-| `update_task` | Update task title, description, status, priority, or metadata |
-| `complete_task` | Mark a task as completed |
-| `next_task` | Get the next recommended task based on priority/dependencies |
+| Tool | Description | Preferences |
+|------|-------------|-------------|
+| `list_tasks` | List all tasks, optionally filtered by status or assignee | ✓ hint |
+| `get_task` | Get a specific task by ID with subtasks | ✓ hint |
+| `add_task` | Create a new task | ✓ hint |
+| `update_task` | Update task title, description, status, priority, or metadata | ✓ hint |
+| `complete_task` | Mark a task as completed | |
+| `next_task` | Get the next recommended task based on priority/dependencies | ✓ hint |
 
 ### Multi-Agent Coordination
 
@@ -250,12 +316,63 @@ init_project({ force: true })
 
 ### Prompt-Based Tools
 
+| Tool | Description | Preferences |
+|------|-------------|-------------|
+| `parse_prd` | Get prompt to parse PRD into tasks | ✓ full |
+| `research_task` | Get prompt to research a task | ✓ full |
+| `analyse_complexity` | Get prompt to analyse task complexity | ✓ full |
+| `check_compliance` | Check file/folder against user preferences from shared context | ✓ full |
+| `analyse_project` | Analyse project structure and suggest memory_bank updates | ✓ full |
+
+### Utility Tools
+
 | Tool | Description |
 |------|-------------|
-| `parse_prd` | Get prompt to parse PRD into tasks |
-| `research_task` | Get prompt to research a task |
-| `analyze_complexity` | Get prompt to analyze task complexity |
-| `check_compliance` | Check file/folder against user preferences from shared context |
+| `get_version` | Get the current version of the MCP task server |
+| `show_memory` | Show shared context memories from `~/.cursor/shared-context.json` |
+| `update_memory` | Create, update, or delete memories in shared context |
+
+```typescript
+// Check the server version
+get_version()
+// Returns: { name: "mcp-task-server", version: "0.2.0", description: "..." }
+
+// Show all memories
+show_memory()
+
+// Search for specific memories
+show_memory({ search: "writing" })
+
+// Force reload from file (clears cache)
+show_memory({ reload: true })
+
+// Create a new memory
+update_memory({ 
+  action: "create", 
+  title: "Project conventions", 
+  content: "Use TypeScript strict mode. Prefer functional components." 
+})
+
+// Update an existing memory
+update_memory({ 
+  action: "update", 
+  id: "mem_123", 
+  title: "Writing preferences", 
+  content: "Updated content..." 
+})
+
+// Delete a memory
+update_memory({ action: "delete", id: "mem_123" })
+
+// Analyse project and get suggestions for memory_bank
+analyse_project()
+
+// Focus on specific area
+analyse_project({ focus: "tech" })      // Just tech stack
+analyse_project({ focus: "brief" })     // Just project brief
+analyse_project({ focus: "active" })    // Just current focus
+analyse_project({ focus: "architecture" })  // Just architecture
+```
 
 ## Multi-Agent Mode
 
@@ -264,7 +381,7 @@ The server supports three agent roles:
 ### Planner
 - Creates and organizes tasks
 - Sets dependencies and priorities
-- Analyzes complexity
+- Analyses complexity
 - Cannot execute tasks
 
 ### Worker  
@@ -311,12 +428,29 @@ your-project/
 │   ├── HANDOFF.md          # Handoff protocol reference
 │   └── SHARED_CONTEXT.md   # Shared context documentation
 ├── memory_bank/
+│   ├── architecture/
+│   │   ├── architecture.md # High-level architecture overview
+│   │   ├── tech.md         # Technical stack and context
+│   │   ├── models.md       # Data models
+│   │   ├── services.md     # System services
+│   │   ├── deployment.md   # Deployment guide
+│   │   ├── kubernetes.md   # Kubernetes deployment (if applicable)
+│   │   └── webhooks.md     # Webhooks implementation (if applicable)
 │   ├── context/
+│   │   ├── context.md      # Context index
 │   │   ├── brief.md        # Project overview
-│   │   └── active.md       # Current focus
+│   │   ├── active.md       # Current focus
+│   │   ├── product.md      # Product context
+│   │   ├── canvas.md       # Lean canvas
+│   │   └── changelog.md    # Change log
 │   ├── execution/
+│   │   ├── execution.md    # Execution overview
 │   │   ├── progress.md     # Task summary (auto-synced)
-│   │   └── decisions.md    # Decision log
+│   │   ├── decisions.md    # Decision log
+│   │   ├── debug.md        # Debug diary
+│   │   └── git.md          # Git setup and code quality
+│   ├── reference/
+│   │   └── README.md       # Reference materials folder
 │   └── tasks/
 │       ├── tasks.json      # Task registry (source of truth)
 │       ├── task_001.txt    # Detailed task file
@@ -327,6 +461,8 @@ your-project/
         └── agent-workflow.mdc  # Cursor agent rules
 ```
 
+The full structure includes 22 template files covering architecture, context, and execution tracking.
+
 ## Migration from v1.x
 
 If you have existing `.taskmaster/tasks.json`:

package/dist/agents.js

@@ -9,7 +9,7 @@ const ROLE_PERMISSIONS = {
         "expand_task",
         "parse_prd",
         "set_dependencies",
-        "analyze_complexity",
+        "analyse_complexity",
         "remove_task",
     ]),
     worker: new Set([

package/dist/context.d.ts

@@ -35,4 +35,23 @@ export declare function getWorkflowPreferences(): string | null;
  * Clear the cached context (useful for testing or reloading)
  */
 export declare function clearContextCache(): void;
+/**
+ * Save shared context to ~/.cursor/shared-context.json
+ */
+export declare function saveSharedContext(context: SharedContext): void;
+/**
+ * Add or update a memory in shared context
+ */
+export declare function upsertMemory(memory: CursorMemory): SharedContext;
+/**
+ * Delete a memory from shared context by ID
+ */
+export declare function deleteMemory(id: string): {
+    deleted: boolean;
+    context: SharedContext | null;
+};
+/**
+ * Generate a unique ID for a new memory
+ */
+export declare function generateMemoryId(): string;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAgBxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAOvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAgBxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAOvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAY9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAiBhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAgB5F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/context.js

@@ -67,4 +67,58 @@ export function getWorkflowPreferences() {
 export function clearContextCache() {
     cachedContext = null;
 }
+/**
+ * Save shared context to ~/.cursor/shared-context.json
+ */
+export function saveSharedContext(context) {
+    const contextPath = join(homedir(), ".cursor", "shared-context.json");
+    const { writeFileSync, mkdirSync } = require("fs");
+    // Ensure .cursor directory exists
+    const cursorDir = join(homedir(), ".cursor");
+    if (!existsSync(cursorDir)) {
+        mkdirSync(cursorDir, { recursive: true });
+    }
+    writeFileSync(contextPath, JSON.stringify(context, null, 2));
+    cachedContext = context;
+}
+/**
+ * Add or update a memory in shared context
+ */
+export function upsertMemory(memory) {
+    let ctx = loadSharedContext();
+    if (!ctx) {
+        ctx = { cursor_memories: [] };
+    }
+    const existingIndex = ctx.cursor_memories.findIndex((m) => m.id === memory.id);
+    if (existingIndex >= 0) {
+        ctx.cursor_memories[existingIndex] = memory;
+    }
+    else {
+        ctx.cursor_memories.push(memory);
+    }
+    saveSharedContext(ctx);
+    return ctx;
+}
+/**
+ * Delete a memory from shared context by ID
+ */
+export function deleteMemory(id) {
+    const ctx = loadSharedContext();
+    if (!ctx) {
+        return { deleted: false, context: null };
+    }
+    const initialLength = ctx.cursor_memories.length;
+    ctx.cursor_memories = ctx.cursor_memories.filter((m) => m.id !== id);
+    if (ctx.cursor_memories.length < initialLength) {
+        saveSharedContext(ctx);
+        return { deleted: true, context: ctx };
+    }
+    return { deleted: false, context: ctx };
+}
+/**
+ * Generate a unique ID for a new memory
+ */
+export function generateMemoryId() {
+    return `mem_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+}
 //# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAY9C,IAAI,aAAa,GAAyB,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAEtE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/D,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,OAAO,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/C,OAAO,GAAG,CAAC,eAAe;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;SAC1C,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IACvD,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GACV,gBAAgB,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC/E,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,10 +4,13 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { getConfig } from "./config.js";
 import * as tools from "./tools.js";
+import { loadSharedContext, getWritingPreferences, getUserIdentity, getWorkflowPreferences, clearContextCache, upsertMemory, deleteMemory, generateMemoryId, } from "./context.js";
+// Version constant - update with each release
+const VERSION = "0.2.1";
 const config = getConfig();
 const server = new Server({
     name: "mcp-task-server",
-    version: "0.1.0",
+    version: VERSION,
 }, {
     capabilities: {
         tools: {},
@@ -287,12 +290,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 },
             },
             {
-                name: "analyze_complexity",
-                description: "Get a prompt to analyze task complexity (Planner role)",
+                name: "analyse_complexity",
+                description: "Get a prompt to analyse task complexity (Planner role)",
                 inputSchema: {
                     type: "object",
                     properties: {
-                        task_id: { type: "string", description: "ID of the task to analyze" },
+                        task_id: { type: "string", description: "ID of the task to analyse" },
                         agent_id: { type: "string" },
                         role: { type: "string", enum: ["planner", "worker", "judge"] },
                     },
@@ -313,10 +316,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["path"],
                 },
             },
-            // Project Initialization
+            // Project Initialisation
             {
                 name: "init_project",
-                description: "Initialize a project with agent-kit, memory_bank, and cursor rules. Creates directory structure and template files. Safe to run on existing projects (will not overwrite files with content unless force: true).",
+                description: "Initialise a project with agent-kit, memory_bank, and cursor rules. Creates directory structure and template files. Safe to run on existing projects (will not overwrite files with content unless force: true).",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -325,6 +328,74 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     },
                 },
             },
+            // Utility Tools
+            {
+                name: "get_version",
+                description: "Get the current version of the MCP task server",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "show_memory",
+                description: "Show shared context memories from ~/.cursor/shared-context.json. Displays all memories or filter by search term.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        search: {
+                            type: "string",
+                            description: "Optional search term to filter memories by title",
+                        },
+                        reload: {
+                            type: "boolean",
+                            description: "Force reload from file (clears cache)",
+                            default: false,
+                        },
+                    },
+                },
+            },
+            {
+                name: "update_memory",
+                description: "Create, update, or delete a memory in ~/.cursor/shared-context.json. Use action: 'create' or 'update' with title and content, or action: 'delete' with id.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        action: {
+                            type: "string",
+                            enum: ["create", "update", "delete"],
+                            description: "Action to perform: create new memory, update existing, or delete",
+                        },
+                        id: {
+                            type: "string",
+                            description: "Memory ID (required for update/delete, auto-generated for create)",
+                        },
+                        title: {
+                            type: "string",
+                            description: "Memory title (required for create/update)",
+                        },
+                        content: {
+                            type: "string",
+                            description: "Memory content (required for create/update)",
+                        },
+                    },
+                    required: ["action"],
+                },
+            },
+            {
+                name: "analyse_project",
+                description: "Analyse the project structure and generate suggestions for memory_bank files. Scans the codebase and returns a prompt with suggested updates for brief.md, tech.md, active.md, etc.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        focus: {
+                            type: "string",
+                            enum: ["all", "brief", "tech", "architecture", "active"],
+                            description: "Which memory_bank area to focus on (default: all)",
+                        },
+                    },
+                },
+            },
         ],
     };
 });
@@ -374,13 +445,174 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             return tools.parsePrd(config, tools.ParsePrdSchema.parse(args));
         case "research_task":
             return tools.researchTask(config, tools.ResearchTaskSchema.parse(args));
-        case "analyze_complexity":
-            return tools.analyzeComplexity(config, tools.AnalyzeComplexitySchema.parse(args));
+        case "analyse_complexity":
+            return tools.analyseComplexity(config, tools.AnalyseComplexitySchema.parse(args));
         case "check_compliance":
             return tools.checkCompliance(config, tools.CheckComplianceSchema.parse(args));
         // Project Initialization
         case "init_project":
             return tools.initProject(config, tools.InitProjectSchema.parse(args));
+        // Project Analysis
+        case "analyse_project":
+            return tools.analyseProject(config, tools.AnalyseProjectSchema.parse(args));
+        // Utility Tools
+        case "get_version":
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            name: "mcp-task-server",
+                            version: VERSION,
+                            description: "MCP server for task management with multi-agent coordination",
+                        }, null, 2),
+                    },
+                ],
+            };
+        case "show_memory": {
+            const { search, reload } = args;
+            // Clear cache if reload requested
+            if (reload) {
+                clearContextCache();
+            }
+            const ctx = loadSharedContext();
+            if (!ctx || !ctx.cursor_memories?.length) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "no_context",
+                                message: "No shared context found.",
+                                path: "~/.cursor/shared-context.json",
+                                hint: "Use update_memory to create your first memory, or the file will be created automatically.",
+                                file_format: {
+                                    cursor_memories: [
+                                        { id: "string", title: "string", content: "string" }
+                                    ],
+                                },
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Filter memories if search provided
+            let memories = ctx.cursor_memories;
+            if (search) {
+                memories = memories.filter((m) => m.title.toLowerCase().includes(search.toLowerCase()) ||
+                    m.content.toLowerCase().includes(search.toLowerCase()));
+            }
+            // Build recognized categories
+            const recognized = {
+                identity: getUserIdentity() ? "✓ found" : "✗ not found",
+                writing_preferences: getWritingPreferences() ? "✓ found" : "✗ not found",
+                workflow: getWorkflowPreferences() ? "✓ found" : "✗ not found",
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "ok",
+                            total_memories: ctx.cursor_memories.length,
+                            showing: memories.length,
+                            search: search || null,
+                            recognized_categories: recognized,
+                            memories: memories.map((m) => ({
+                                id: m.id,
+                                title: m.title,
+                                content_preview: m.content.length > 200
+                                    ? m.content.substring(0, 200) + "..."
+                                    : m.content,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        case "update_memory": {
+            const { action, id, title, content } = args;
+            if (action === "delete") {
+                if (!id) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    status: "error",
+                                    message: "id is required for delete action",
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                const result = deleteMemory(id);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                status: result.deleted ? "deleted" : "not_found",
+                                id,
+                                total_memories: result.context?.cursor_memories?.length || 0,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Create or update
+            if (!title || !content) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "error",
+                                message: "title and content are required for create/update action",
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const memoryId = action === "create" ? generateMemoryId() : id;
+            if (action === "update" && !id) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "error",
+                                message: "id is required for update action",
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const memory = {
+                id: memoryId,
+                title,
+                content,
+            };
+            const ctx = upsertMemory(memory);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: action === "create" ? "created" : "updated",
+                            memory: {
+                                id: memory.id,
+                                title: memory.title,
+                                content_preview: memory.content.length > 200
+                                    ? memory.content.substring(0, 200) + "..."
+                                    : memory.content,
+                            },
+                            total_memories: ctx.cursor_memories.length,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
         default:
             throw new Error(`Unknown tool: ${name}`);
     }