@liangshanli/mcp-server-project-standards 1.0.0

package/bin/cli.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// 简单日志输出
+const writeLog = (level, message, data = null) => {
+  console.error(`[${level}] ${message}`);
+};
+
+// Get server script path
+const serverPath = path.resolve(__dirname, '../src/server-final.js');
+
+// Check if server file exists
+if (!fs.existsSync(serverPath)) {
+  const errorMsg = `Server file not found: ${serverPath}`;
+  writeLog('ERROR', errorMsg);
+  process.exit(1);
+}
+
+writeLog('INFO', `Starting MCP Project Standards server from: ${serverPath}`);
+
+let server = null;
+
+// Function to start server
+function startServer() {
+  // Create environment object
+  const env = {
+    ...process.env,
+    // Set CONFIG_DIR if specified, otherwise use default
+    CONFIG_DIR: process.env.CONFIG_DIR || './.setting'
+  };
+
+  writeLog('INFO', 'Starting MCP Project Standards server');
+
+  server = spawn('node', [serverPath], {
+    stdio: ['inherit', 'inherit', 'inherit'],
+    env: env
+  });
+
+  writeLog('INFO', `MCP Project Standards server process started with PID: ${server.pid}`);
+
+  // Add signal handling debug info
+  writeLog('INFO', 'Signal handlers registered for SIGINT and SIGTERM');
+  writeLog('INFO', 'Press Ctrl+C to gracefully shutdown the server');
+}
+
+// Start the server
+startServer();
+
+// Handle process exit
+server.on('close', (code) => {
+  writeLog('INFO', `MCP Project Standards server exited with code: ${code}`);
+  // Clear any pending shutdown timeout
+  if (global.shutdownTimeout) {
+    clearTimeout(global.shutdownTimeout);
+  }
+  
+  // Check if this is a restart request
+  if (code === 0) {
+    writeLog('INFO', 'Server requested restart, restarting...');
+    setTimeout(() => {
+      startServer();
+    }, 2000); // Wait 2 seconds before restart
+  } else {
+    // Exit CLI process when server exits with error
+    setTimeout(() => {
+      writeLog('INFO', 'CLI process exiting after server shutdown');
+      process.exit(code);
+    }, 1000);
+  }
+});
+
+// Handle server error
+server.on('error', (err) => {
+  writeLog('ERROR', 'Server process error:', {
+    error: err.message,
+    stack: err.stack
+  });
+  process.exit(1);
+});
+
+// Handle errors
+server.on('error', (err) => {
+  writeLog('ERROR', 'Failed to start MCP Project Standards server:', {
+    error: err.message,
+    stack: err.stack
+  });
+  process.exit(1);
+});
+
+// Handle signals
+process.on('SIGINT', () => {
+  writeLog('INFO', 'Received SIGINT, shutting down server...');
+  gracefulShutdown('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  writeLog('INFO', 'Received SIGTERM, shutting down server...');
+  gracefulShutdown('SIGTERM');
+});
+
+// Handle Windows specific signals
+process.on('SIGBREAK', () => {
+  writeLog('INFO', 'Received SIGBREAK, shutting down server...');
+  gracefulShutdown('SIGTERM');
+});
+
+// Handle restart signal from server
+process.on('SIGUSR1', () => {
+  writeLog('INFO', 'Received restart signal from server...');
+  restartServer();
+});
+
+// Handle process exit
+process.on('exit', (code) => {
+  writeLog('INFO', `CLI process exiting with code: ${code}`);
+});
+
+// Graceful shutdown function
+function gracefulShutdown(signal) {
+  // Set a timeout to force exit if server doesn't respond
+  global.shutdownTimeout = setTimeout(() => {
+    writeLog('WARN', 'Server shutdown timeout, forcing exit...');
+    try {
+      if (server) {
+        server.kill('SIGKILL');
+      }
+    } catch (err) {
+      writeLog('ERROR', 'Failed to force kill server:', {
+        error: err.message
+      });
+    }
+    process.exit(1);
+  }, 10000); // 10 seconds timeout
+  
+  // Try graceful shutdown
+  try {
+    if (server) {
+      server.kill(signal);
+      writeLog('INFO', `Sent ${signal} signal to server process ${server.pid}`);
+    } else {
+      writeLog('WARN', 'No server process to shutdown');
+      process.exit(0);
+    }
+  } catch (err) {
+    writeLog('ERROR', `Failed to send ${signal} signal to server:`, {
+      error: err.message
+    });
+    if (global.shutdownTimeout) {
+      clearTimeout(global.shutdownTimeout);
+    }
+    process.exit(1);
+  }
+}
+
+// Restart server function
+function restartServer() {
+  writeLog('INFO', 'Restarting MCP server...');
+  if (server) {
+    try {
+      server.kill('SIGTERM');
+      setTimeout(() => {
+        if (server && !server.killed) {
+          writeLog('WARN', 'Server not responding to SIGTERM, forcing kill...');
+          server.kill('SIGKILL');
+        }
+        startServer();
+      }, 3000); // Wait 3 seconds for graceful shutdown
+    } catch (err) {
+      writeLog('ERROR', 'Failed to stop server for restart:', { error: err.message });
+      startServer();
+    }
+  } else {
+    startServer();
+  }
+}
+
+// Handle uncaught exceptions
+process.on('uncaughtException', (err) => {
+  writeLog('ERROR', 'Uncaught exception in CLI:', {
+    error: err.message,
+    stack: err.stack
+  });
+  server.kill('SIGTERM');
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason, promise) => {
+  writeLog('ERROR', 'Unhandled Promise rejection in CLI:', {
+    reason: reason.toString(),
+    promise: promise.toString()
+  });
+  server.kill('SIGTERM');
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@liangshanli/mcp-server-project-standards",
+  "version": "1.0.0",
+  "description": "MCP Project Standards server with project info, structure, API standards, development standards and custom tools",
+  "main": "bin/cli.js",
+  "bin": {
+    "mcp-server-project-standards": "bin/cli.js"
+  },
+  "scripts": {
+    "start": "node bin/cli.js",
+    "dev": "node --inspect bin/cli.js",
+    "test": "node test-simple.js",
+    "start-managed": "node start-server.js",
+    "daemon": "node start-server.js",
+    "server": "node src/server-final.js"
+  },
+  "keywords": [
+    "mcp",
+    "project",
+    "standards",
+    "api",
+    "development",
+    "tools"
+  ],
+  "author": "liliangshan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/liliangshan/mcp-server-project-standards"
+  },
+  "dependencies": {
+    "fs-extra": "^11.2.0",
+    "path": "^0.12.7"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  }
+}