@n0zer0d4y/vulcan-file-ops 1.2.9 → 1.2.11

package/CHANGELOG.md

@@ -9,6 +9,106 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 
 
+## [1.2.11] - 2026-02-21
+
+### Fixed
+
+- **CRITICAL**: Fixed MCP server toggle failure and "no tools configured" error in Claude Desktop and Cursor.
+  - **Root Cause**: ES Module execution order caused `parseArguments()` to run before console suppression logic. This allowed warning messages to be emitted to the protocol stream, corrupting JSON-RPC communication.
+  - **Solution**: Moved console suppression to the absolute top of `server/index.ts` and deferred argument parsing to the `runServer()` function.
+  - Improved MCP mode detection to exclude `--help` and `--version` flags.
+- See `local_docs/RCA-MCP-Toggle-Failure-Stdout-Pollution-2026-02-21.md` for full details.
+
+## [1.2.10] - 2026-01-31
+
+### Fixed
+
+- **CRITICAL**: Fixed MCP server toggle failure in Claude Desktop caused by capability mismatch
+  - **Root Cause**: Server declared `resources: {}` and `prompts: {}` capabilities but had NO handlers for `resources/list` and `prompts/list` methods
+  - Claude Desktop calls these methods after initialization, receives "Method not found" (-32601) errors, and fails to enable the server toggle
+  - **Solution**: Removed `resources` and `prompts` capability declarations from both Server constructor and initialize response
+  - Per MCP specification: A server MUST NOT declare capabilities for features it does not implement
+  - This bug was originally fixed in v1.2.3 but was reintroduced in v1.2.8 when code was restored to v1.2.1 baseline
+- See `local_docs/RCA-Claude-Desktop-MCP-Capability-Mismatch-2026-01-31.md` for complete root cause analysis
+
+### Changed
+
+- Server now only declares `tools` capability (which is fully implemented)
+- Removed unused capability declarations that caused protocol compliance issues
+
+### References
+
+- [MCPcat Guide: Fix MCP Error -32601](https://mcpcat.io/guides/fixing-method-not-found-32601-error/)
+- MCP Protocol Specification: Capability declaration requirements
+
+## [1.2.9] - 2026-01-31
+
+### Fixed
+
+- **CRITICAL**: Fixed protocol version negotiation causing Claude Desktop connection failures
+  - Server now returns the protocol version requested by the client instead of hardcoded `LATEST_PROTOCOL_VERSION`
+  - Claude Desktop requests `2025-06-18` but previous versions returned `2025-11-25`, causing immediate disconnection
+  - This fix ensures compatibility with all MCP clients regardless of their supported protocol version
+
+### Changed
+
+- Protocol version in initialize response now mirrors client's requested version
+- Added documentation comments explaining protocol version negotiation requirements
+
+## [1.2.8] - 2026-01-31
+
+### Changed
+
+- Restored source code to working v1.2.1 baseline
+- Downgraded `@modelcontextprotocol/sdk` from `^1.25.2` to `1.20.0` for stability
+- Removed experimental console suppression changes that caused issues
+
+### Notes
+
+- This release reverts problematic changes while maintaining SDK 1.20.0 compatibility
+
+## [1.2.7] - 2026-01-31
+
+### Fixed
+
+- Downgraded `@modelcontextprotocol/sdk` to `1.20.0` to resolve Claude Desktop compatibility issues
+- SDK 1.25.x introduced breaking changes in stdio transport and protocol handling
+
+### Changed
+
+- Locked SDK version to exact `1.20.0` (removed caret range)
+
+## [1.2.6] - 2026-01-31
+
+### Fixed
+
+- Silenced dotenv debug output that was polluting stdout and corrupting MCP JSON-RPC protocol
+  - Added `quiet: true` option to `dotenv.config()` call
+- Improved MCP mode detection logic
+  - Changed TTY detection from AND to OR logic: now triggers MCP mode if EITHER stdin OR stdout is piped
+  - This fixes edge cases where different shells/platforms report TTY status inconsistently
+
+### Changed
+
+- Console suppression now activates when any standard stream is piped, not just when both are piped
+
+## [1.2.5] - 2026-01-31
+
+### Fixed
+
+- **CRITICAL**: Fixed ES Module execution order bug causing stdout pollution in MCP mode
+  - Console suppression code in `cli.ts` was ineffective due to ES Module static import hoisting
+  - Child modules (including `server/index.ts`) were evaluated BEFORE parent module's top-level code
+  - Moved console suppression to the top of `server/index.ts` before any imports
+  - Deferred `parseArguments()` call from module-level to inside `runServer()` function
+  - Added `--help` and `--version` flag detection to preserve CLI functionality
+- See `local_docs/RCA-Claude-Desktop-MCP-Toggle-Failure-2026-01-31.md` for complete root cause analysis
+
+### Changed
+
+- MCP mode detection now excludes `--help` and `--version` flags to allow CLI usage
+- Reorganized initialization sequence to ensure console suppression happens before any potential output
+
 ## [1.2.4] - 2026-01-21
 
 ### Fixed

package/dist/cli.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 // CRITICAL: Detect MCP mode and suppress console output BEFORE any imports
 // MCP servers use stdin/stdout for JSON-RPC via stdio transport
-// Detection: stdin/stdout are NOT TTY (piped/redirected) = MCP mode
-const isMCP = (!process.stdin.isTTY && !process.stdout.isTTY) ||
-    process.argv.some((arg) => arg.includes("mcp") || arg.includes("stdio"));
+// Detection: stdin/stdout are NOT TTY (piped/redirected) OR explicit MCP flags are present.
+// Note: We exclude help/version flags to allow CLI usage even when piped.
+const isMCP = ((!process.stdin.isTTY && !process.stdout.isTTY) ||
+    process.argv.some((arg) => arg.includes("mcp") || arg.includes("stdio") || arg.includes("inspector"))) &&
+    !process.argv.some((arg) => arg === "--help" || arg === "-h" || arg === "--version" || arg === "-v");
 if (isMCP) {
     // Suppress all console methods (but NOT stdout/stderr streams - MCP SDK needs those)
     const noop = () => { };

package/dist/server/index.js

@@ -1,4 +1,19 @@
 #!/usr/bin/env node
+// CRITICAL: Console suppression MUST happen BEFORE any other imports
+// due to ES Module static import execution order (imports are evaluated BEFORE top-level code).
+// Detection: stdin/stdout are NOT TTY (piped/redirected) OR explicit MCP flags are present.
+// Note: We exclude help/version flags to allow CLI usage even when piped.
+const _isMCP = ((!process.stdin.isTTY && !process.stdout.isTTY) ||
+    process.argv.some((arg) => arg.includes("mcp") || arg.includes("stdio") || arg.includes("inspector"))) &&
+    !process.argv.some((arg) => arg === "--help" || arg === "-h" || arg === "--version" || arg === "-v");
+if (_isMCP) {
+    const noop = () => { };
+    console.log = noop;
+    console.error = noop;
+    console.warn = noop;
+    console.info = noop;
+    console.debug = noop;
+}
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, InitializeRequestSchema, PingRequestSchema, RootsListChangedNotificationSchema, } from "@modelcontextprotocol/sdk/types.js";
@@ -183,21 +198,12 @@ function parseArguments() {
     }
     return directories;
 }
-const directoryArgs = parseArguments();
+// Defer parsing until runServer is called
+let directoryArgs = [];
 // Async initialization function to be called in runServer()
 async function initializeDirectories() {
     // Detect MCP mode: stdin/stdout are NOT TTY (piped) = MCP mode
-    const isMCP = (!process.stdin.isTTY && !process.stdout.isTTY) ||
-        process.argv.some((arg) => arg.includes("mcp") || arg.includes("stdio"));
-    // During MCP operation, suppress ALL console output to prevent protocol corruption
-    if (isMCP) {
-        const noop = () => { };
-        console.error = noop;
-        console.log = noop;
-        console.warn = noop;
-        console.info = noop;
-        console.debug = noop;
-    }
+    const isMCP = _isMCP;
     if (!isMCP &&
         (approvedFoldersFromArgs.length > 0 ||
             directoryArgs.length > 0 ||
@@ -382,8 +388,10 @@ const server = new Server({
         tools: {
             listChanged: true,
         },
-        resources: {},
-        prompts: {},
+        // CRITICAL: Do NOT declare resources or prompts capabilities
+        // We don't implement handlers for resources/list or prompts/list
+        // Declaring them causes Claude Desktop to call these methods,
+        // receive "Method not found" errors, and fail to enable the toggle
     },
 });
 // Initialize handler - required for MCP protocol
@@ -397,8 +405,7 @@ server.setRequestHandler(InitializeRequestSchema, async (request) => {
             tools: {
                 listChanged: true,
             },
-            resources: {},
-            prompts: {},
+            // CRITICAL: Do NOT declare resources or prompts - we don't implement them
         },
         serverInfo: {
             name: "vulcan-file-ops",
@@ -630,6 +637,7 @@ export async function runServer() {
     // Initialize directories before starting server
     // BUT: Don't exit on errors during MCP mode - just log and continue
     try {
+        directoryArgs = parseArguments();
         await initializeDirectories();
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n0zer0d4y/vulcan-file-ops",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "mcpName": "io.github.n0zer0d4y/vulcan-file-ops",
   "description": "MCP server for AI assistants: read, write, edit, and manage files securely on local filesystem.",
   "license": "MIT",