converse-mcp-server 3.1.0 → 3.2.0

package/bin/converse.js

@@ -2,13 +2,21 @@
 
 /**
  * Converse MCP Server - CLI Entry Point
- * 
+ *
  * This script allows the MCP server to be run via npx/pnpm dlx for easy installation and execution.
  */
 
 import { fileURLToPath, pathToFileURL } from 'url';
 import { dirname, join } from 'path';
 import { createRequire } from 'module';
+import { getPackageVersion } from '../src/utils/version.js';
+
+// Answer --version before loading the server: version.js pulls in nothing but
+// node builtins, so this stays a sub-100ms round trip for `npx converse -v`.
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  console.log(getPackageVersion());
+  process.exit(0);
+}
 
 // Capture the caller's working directory before we chdir to the package root.
 // This is critical for resolving relative file paths passed by MCP clients.
@@ -45,4 +53,4 @@ try {
   // For http transport, this will be logged by the error handler in main
   // Just exit with error code
   process.exit(1);
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "converse-mcp-server",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Converse MCP Server - Converse with other LLMs with chat and consensus tools",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -19,7 +19,8 @@ import {
 import { createRouter } from './router.js';
 import { createHTTPTransport } from './transport/httpTransport.js';
 import { createLogger, startTimer } from './utils/logger.js';
-import { debugError } from './utils/console.js';
+import { debugError, forceLog } from './utils/console.js';
+import { getPackageVersion } from './utils/version.js';
 import { ConfigurationError } from './utils/errorHandler.js';
 
 const logger = createLogger('server');
@@ -36,7 +37,8 @@ Usage: node src/index.js [OPTIONS]
 Options:
   --transport <type>    Transport type: stdio (default) or http
   --transport=<type>    Alternative format for transport type
-  --help               Show this help message
+  --version, -v         Print the server version and exit
+  --help, -h            Show this help message
 
 Environment Variables:
   MCP_TRANSPORT        Transport type (stdio or http)
@@ -90,8 +92,16 @@ function getTransportType() {
 }
 
 async function main() {
-  // Check for help flag
   const args = process.argv.slice(2);
+
+  // Version is printed unconditionally (not via debugError) so it still reaches
+  // stdout when MCP_TRANSPORT=stdio is set — the process exits before any
+  // JSON-RPC traffic starts, so there is no stream to corrupt.
+  if (args.includes('--version') || args.includes('-v')) {
+    forceLog(getPackageVersion());
+    process.exit(0);
+  }
+
   if (args.includes('--help') || args.includes('-h')) {
     showHelp();
     process.exit(0);

package/src/resources/helpResource.js

@@ -6,26 +6,7 @@
  */
 
 import { generateHelpContent } from '../prompts/helpPrompt.js';
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * Get the current server version from package.json
- * @returns {string} Server version
- */
-function getServerVersion() {
-  try {
-    const packagePath = join(__dirname, '../../package.json');
-    const packageJson = JSON.parse(readFileSync(packagePath, 'utf8'));
-    return packageJson.version || 'unknown';
-  } catch (error) {
-    return 'unknown';
-  }
-}
+import { getPackageVersion } from '../utils/version.js';
 
 /**
  * Resource metadata for the help documentation
@@ -45,7 +26,7 @@ export const helpResourceMetadata = {
  */
 export async function helpResourceHandler(config = null) {
   const helpContent = generateHelpContent(config);
-  const version = getServerVersion();
+  const version = getPackageVersion();
 
   // Add version information to the help content
   const contentWithVersion = `${helpContent}\n\n## Server Information\n\n- **Version**: ${version}\n- **Protocol**: MCP (Model Context Protocol)\n- **Server Type**: HTTP Transport\n- **Default Port**: 3157\n`;

package/src/utils/version.js

@@ -0,0 +1,32 @@
+/**
+ * Package Version Utility
+ *
+ * Single source for the server version so the CLI, MCP handshake and help
+ * resource never disagree about which version is running.
+ */
+
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+let cachedVersion;
+
+/**
+ * Get the server version from package.json
+ * @returns {string} Semver string, or 'unknown' if package.json is unreadable
+ */
+export function getPackageVersion() {
+  if (cachedVersion === undefined) {
+    try {
+      const packagePath = join(
+        dirname(fileURLToPath(import.meta.url)),
+        '../../package.json',
+      );
+      cachedVersion = JSON.parse(readFileSync(packagePath, 'utf8')).version || 'unknown';
+    } catch {
+      cachedVersion = 'unknown';
+    }
+  }
+
+  return cachedVersion;
+}