Add CHANGELOG.md for version tracking, revert module type to CommonJS in package.json, update tsconfig.json for CommonJS compatibility, and refactor imports in source files to remove .js extensions. Fix critical issues related to ES Module compatibility and improve WebSocket server initialization.

louisfghbvc · louisfghbvc · commit c293a8d8dc07 · 2025-08-15T02:43:37.000-07:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,88 @@
+# Change Log
+
+All notable changes to the "MCP VSCode Commands" extension will be documented in this file.
+
+Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
+
+## [Unreleased]
+
+## [0.1.2] - 2025-08-15
+
+### 🐛 Fixed
+- **Critical**: Fixed ES Module compatibility issue preventing extension activation
+  - Reverted from ESM to CommonJS module system for VSCode compatibility
+  - Maintained dynamic imports for @modelcontextprotocol/sdk (ESM package)
+- **Critical**: Fixed "undefined_publisher" issue by adding publisher field to package.json
+- Fixed async/await usage in WebSocket server initialization
+
+### 🔧 Changed
+- Updated TypeScript configuration:
+  - Module output: CommonJS (required for VSCode extensions)
+  - Target: ES2022 (for modern JavaScript features)
+  - Added moduleResolution: "node" for better compatibility
+- Removed `.js` extensions from local imports (CommonJS style)
+- Optimized `.vscodeignore` to reduce package size
+
+### ✨ Added
+- Added `publisher` field in package.json (louisfghbvc)
+- Created `.vscodeignore` file to exclude unnecessary files from VSIX package
+- Added this CHANGELOG.md file
+
+## [0.1.1] - 2025-08-14
+
+### ✨ Added
+- WebSocket server support on port 3001 for remote MCP connections
+- Enhanced error handling with detailed error messages
+- Improved logging system with timestamp and context
+
+### 🔧 Changed
+- Improved command execution result serialization
+- Better handling of VSCode-specific objects (URI, Range, Position)
+- Enhanced command listing with filtering support
+
+### 📚 Documentation
+- Added WebSocket configuration examples
+- Updated README with connection instructions
+
+## [0.1.0] - 2025-08-14
+
+### 🎉 Initial Release
+
+#### Core Features
+- **MCP Server Implementation**: Full Model Context Protocol server for VSCode
+- **Command Execution**: Execute any VSCode command via MCP protocol
+- **Command Discovery**: List and filter all available VSCode commands
+- **Auto-start Support**: Configurable automatic server startup
+
+#### Tools Available
+- `vscode.executeCommand`: Execute VSCode commands with arguments
+- `vscode.listCommands`: List all available commands with optional filtering
+
+#### Configuration
+- `mcpVscodeCommands.autoStart`: Auto-start server on extension activation (default: true)
+- `mcpVscodeCommands.logLevel`: Configure logging verbosity (debug|info|warn|error)
+
+#### Transport Support
+- Stdio transport for local connections
+- WebSocket transport for remote connections (port 3001)
+
+#### Developer Features
+- TypeScript implementation with strict typing
+- Comprehensive error handling
+- Detailed logging for debugging
+- Clean architecture with separated concerns
+
+---
+
+## Version History Summary
+
+| Version | Date | Status | Key Changes |
+|---------|------|--------|-------------|
+| 0.1.2 | 2025-01-15 | Current | Fixed critical ES Module compatibility issues |
+| 0.1.1 | 2025-01-14 | Released | Added WebSocket support |
+| 0.1.0 | 2025-01-13 | Released | Initial release with core MCP functionality |
+
+## Links
+- [GitHub Repository](https://github.com/louisfghbvc/mcp-vscode-commands)
+- [Report Issues](https://github.com/louisfghbvc/mcp-vscode-commands/issues)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
diff --git a/package.json b/package.json
@@ -5,7 +5,6 @@
   "version": "0.1.2",
   "author": "louisfghbvc",
   "publisher": "louisfghbvc",
-  "type": "module",
   "engines": {
     "vscode": "^1.74.0"
   },
diff --git a/src/extension.ts b/src/extension.ts
@@ -1,6 +1,6 @@
 import * as vscode from 'vscode';
-import { MCPVSCodeServer } from './mcp-server.js';
-import { MCPServerConfig } from './types.js';
+import { MCPVSCodeServer } from './mcp-server';
+import { MCPServerConfig } from './types';
 
 let mcpServer: MCPVSCodeServer | undefined;
 
diff --git a/src/mcp-server.ts b/src/mcp-server.ts
@@ -1,10 +1,13 @@
 import * as vscode from 'vscode';
-import WebSocket from 'ws';
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { MCPServerConfig, CommandExecutionResult, LogContext } from './types.js';
-import { VSCodeCommandsTools } from './tools/vscode-commands.js';
+import * as WebSocket from 'ws';
+import { MCPServerConfig, CommandExecutionResult, LogContext } from './types';
+import { VSCodeCommandsTools } from './tools/vscode-commands';
+
+// Dynamic imports for ES modules
+let Server: any;
+let StdioServerTransport: any;
+let CallToolRequestSchema: any;
+let ListToolsRequestSchema: any;
 
 export class MCPVSCodeServer {
     private server: any;
@@ -22,10 +25,20 @@ export class MCPVSCodeServer {
         this.tools = new VSCodeCommandsTools(this.config);
     }
 
-    private initializeServer(): void {
+    private async loadESModules(): Promise<void> {
         if (this.initialized) return;
         
         try {
+            // Dynamic import of ES modules
+            const serverModule = await import('@modelcontextprotocol/sdk/server/index.js');
+            const stdioModule = await import('@modelcontextprotocol/sdk/server/stdio.js');
+            const typesModule = await import('@modelcontextprotocol/sdk/types.js');
+            
+            Server = serverModule.Server;
+            StdioServerTransport = stdioModule.StdioServerTransport;
+            CallToolRequestSchema = typesModule.CallToolRequestSchema;
+            ListToolsRequestSchema = typesModule.ListToolsRequestSchema;
+            
             // 初始化 MCP 服務器
             this.server = new Server({
                 name: 'mcp-vscode-commands',
@@ -38,7 +51,7 @@ export class MCPVSCodeServer {
             this.initialized = true;
             this.log('info', 'MCP VSCode Server 已初始化');
         } catch (error) {
-            this.log('error', 'Failed to initialize server', { error: String(error) });
+            this.log('error', 'Failed to load ES modules', { error: String(error) });
             throw error;
         }
     }
@@ -167,8 +180,8 @@ export class MCPVSCodeServer {
 
     async start(): Promise<void> {
         try {
-            // Initialize server
-            this.initializeServer();
+            // Load ES modules first
+            await this.loadESModules();
             
             // 同時啟動 stdio 和 WebSocket transport
             await this.startStdioTransport();
@@ -189,11 +202,11 @@ export class MCPVSCodeServer {
     }
 
     private async startWebSocketServer(): Promise<void> {
-        return new Promise(async (resolve, reject) => {
+        return new Promise((resolve, reject) => {
             try {
                 // 創建 HTTP server
-                const { createServer } = await import('http');
-                this.httpServer = createServer();
+                const http = require('http');
+                this.httpServer = http.createServer();
                 
                 // 創建 WebSocket server
                 this.wsServer = new WebSocket.Server({ 
@@ -222,9 +235,9 @@ export class MCPVSCodeServer {
     }
 
     private async handleWebSocketConnection(ws: WebSocket.WebSocket): Promise<void> {
-        // Ensure server is initialized
+        // Ensure ES modules are loaded
         if (!this.initialized) {
-            this.initializeServer();
+            await this.loadESModules();
         }
         
         // 為每個 WebSocket 連接創建新的 server 實例
diff --git a/src/tools/index.ts b/src/tools/index.ts
@@ -2,4 +2,4 @@
  * MCP Tools 導出模組
  */
 
-export { VSCodeCommandsTools } from './vscode-commands.js';
+export { VSCodeCommandsTools } from './vscode-commands';
diff --git a/src/tools/vscode-commands.ts b/src/tools/vscode-commands.ts
@@ -1,5 +1,5 @@
 import * as vscode from 'vscode';
-import { CommandExecutionResult, MCPServerConfig } from '../types.js';
+import { CommandExecutionResult, MCPServerConfig } from '../types';
 
 export class VSCodeCommandsTools {
     private config: MCPServerConfig;
diff --git a/tsconfig.json b/tsconfig.json
@@ -1,6 +1,6 @@
 {
   "compilerOptions": {
-    "module": "ES2022",
+    "module": "commonjs",
     "target": "ES2022",
     "outDir": "out",
     "lib": [

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"compilerOptions": {`
`3`		`- "module": "ES2022",`
	`3`	`+ "module": "commonjs",`
`4`	`4`	`"target": "ES2022",`
`5`	`5`	`"outDir": "out",`
`6`	`6`	`"lib": [`