x

Author: svincent240

main/chat-engine.js

@@ -1403,6 +1403,15 @@ async function executeTool(toolName, toolInput, projectPath, webContents) {
         if (result?.content && Array.isArray(result.content)) {
             // Check for error responses
             if (result.isError) {
+                const structuredError = result.structuredContent?.error;
+                if (structuredError && typeof structuredError === 'object') {
+                    return {
+                        error: structuredError.message || result.structuredContent.message || 'Tool returned an error',
+                        code: structuredError.code || result.structuredContent.code,
+                        hint: structuredError.hint || result.structuredContent.hint,
+                        details: structuredError.details || result.structuredContent.details
+                    };
+                }
                 const text = result.content.map(c => c.text || '').join('');
                 return { error: text || 'Tool returned an error' };
             }

main/mcp-client.js

@@ -1,5 +1,6 @@
 import { spawn } from 'child_process';
 import { app } from 'electron';
+import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
 import { getProjectCLISpawnArgs, getChildEnv, killProcessTree } from './node-env.js';
 import { getPreviewPort } from './preview-manager.js';
 import { createLogger } from './logger.js';
@@ -172,7 +173,7 @@ class McpConnection {
 
         this.initPromise = (async () => {
             const result = await this.request('initialize', {
-                protocolVersion: '2024-11-05',
+                protocolVersion: LATEST_PROTOCOL_VERSION,
                 capabilities: {},
                 clientInfo: { name: 'coursecode-desktop', version: app.getVersion() }
             });

package-lock.json

@@ -43,10 +43,11 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.91.1",
     "@electron-toolkit/utils": "^4.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@tiptap/core": "^3.22.4",
     "@tiptap/markdown": "^3.22.4",
     "@tiptap/starter-kit": "^3.22.4",
-    "coursecode": "^0.1.43",
+    "coursecode": "^0.1.46",
     "electron-updater": "^6.3.9",
     "isomorphic-git": "^1.37.6",
     "marked": "^18.0.2",

package.json

@@ -73,7 +73,8 @@ A standalone Electron app that gives instructional designers a native GUI for Co
   - GitHub Release artifact names must match the website download metadata naming convention (`CourseCode-Desktop-v<version>-mac.dmg`, `CourseCode-Desktop-v<version>-win.exe`)
 - Runtime version reporting rules:
   - App UI "About" and update checks must use Electron `app.getVersion()`
-  - MCP client handshake version must use the app runtime version, not a hardcoded string
+  - MCP client metadata must send Electron `app.getVersion()` as the Desktop runtime version
+  - MCP protocol negotiation must use the SDK's current `LATEST_PROTOCOL_VERSION`, not a hardcoded protocol date
 - Changelogs should distinguish:
   - Desktop app changes (open source)
   - Framework/CLI changes (open source)
@@ -823,7 +824,7 @@ Defined in `ai-config.js` as `FILE_TOOL_DEFINITIONS`. These execute locally via
 
 #### MCP Tools (framework-provided)
 
-Discovered at runtime from the CourseCode framework's MCP server via stdio JSON-RPC (`coursecode mcp --port <port>`). The MCP connection is managed by `mcp-client.js`. The desktop app assumes the MCP server is **always available** when a preview is running; MCP tools are only included in the tool list when a preview server is active.
+Discovered at runtime from the CourseCode framework's MCP server via stdio JSON-RPC (`coursecode mcp --port <port>`). The MCP connection is managed by `mcp-client.js`. The desktop app assumes the MCP server is **always available** when a preview is running; MCP tools are only included in the tool list when a preview server is active. Desktop depends directly on `@modelcontextprotocol/sdk` so the client can negotiate with the SDK's current `LATEST_PROTOCOL_VERSION` while still sending the Electron app version as client metadata. Framework MCP tools return `structuredContent` for machine-readable results while keeping text content for compatibility. When MCP tools fail, Desktop preserves structured fields such as `code`, `hint`, and `details` so the AI can recover from tool errors without parsing prose.
 
 | Tool | Purpose |
 |---|---|