@aashari/boilerplate-mcp-server 1.4.9 → 1.5.1

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## [1.5.1](https://github.com/aashari/boilerplate-mcp-server/compare/v1.5.0...v1.5.1) (2025-05-05)
+
+
+### Bug Fixes
+
+* Improve cross-platform compatibility for npx execution ([d840c51](https://github.com/aashari/boilerplate-mcp-server/commit/d840c51cc94ad3d54e5c38670b774cdb7d52b8a7))
+
+
+### Performance Improvements
+
+* Update dependencies ([cbc63fe](https://github.com/aashari/boilerplate-mcp-server/commit/cbc63fe692f563a3e1b68bb136b8f567408fbf9c))
+
+# [1.5.0](https://github.com/aashari/boilerplate-mcp-server/compare/v1.4.9...v1.5.0) (2025-05-05)
+
+
+### Features
+
+* **boilerplate:** add standard pagination utils and formatPagination ([cb1e004](https://github.com/aashari/boilerplate-mcp-server/commit/cb1e004fcb33eef61605983b74cf8a373018830b))
+
 ## [1.4.9](https://github.com/aashari/boilerplate-mcp-server/compare/v1.4.8...v1.4.9) (2025-05-04)
 
 

package/dist/index.js

@@ -105,6 +105,17 @@ async function main() {
         await startServer();
         mainLogger.info('Server is now running');
     }
+    // --- Start: Add Graceful Shutdown ---
+    const shutdown = async (signal) => {
+        mainLogger.info(`Received ${signal}. Shutting down gracefully...`);
+        // Add any specific cleanup logic here if needed in the future
+        // For now, just exiting cleanly is the main goal
+        // No need to explicitly call server disconnect if process exits
+        process.exit(0);
+    };
+    process.on('SIGINT', () => shutdown('SIGINT')); // Ctrl+C
+    process.on('SIGTERM', () => shutdown('SIGTERM')); // kill command
+    // --- End: Add Graceful Shutdown ---
 }
 // If this file is being executed directly (not imported), run the main function
 if (require.main === module) {

package/dist/types/common.types.d.ts

@@ -3,27 +3,6 @@
  * These types provide a standard interface for controller interactions.
  * Centralized here to ensure consistency across the codebase.
  */
-/**
- * Common pagination information for API responses.
- * This is used for providing consistent pagination details to clients.
- */
-export interface ResponsePagination {
-    /**
-     * Cursor for the next page of results, if available.
-     * This should be passed to subsequent requests to retrieve the next page.
-     */
-    nextCursor?: string;
-    /**
-     * Whether more results are available beyond the current page.
-     * When true, clients should use the nextCursor to retrieve more results.
-     */
-    hasMore: boolean;
-    /**
-     * The number of items in the current result set.
-     * This helps clients track how many items they've received.
-     */
-    count?: number;
-}
 /**
  * Common response structure for controller operations.
  * All controller methods should return this structure.
@@ -35,8 +14,7 @@ export interface ControllerResponse {
      */
     content: string;
     /**
-     * Optional pagination information for list operations.
-     * If present, indicates that more results are available.
+     * Optional metadata for any extra information associated with the response.
      */
-    pagination?: ResponsePagination;
+    metadata?: Record<string, unknown>;
 }

package/dist/utils/constants.util.d.ts

@@ -8,7 +8,7 @@
  * Current application version
  * This should match the version in package.json
  */
-export declare const VERSION = "1.4.9";
+export declare const VERSION = "1.5.1";
 /**
  * Package name with scope
  * Used for initialization and identification

package/dist/utils/constants.util.js

@@ -11,7 +11,7 @@ exports.CLI_NAME = exports.PACKAGE_NAME = exports.VERSION = void 0;
  * Current application version
  * This should match the version in package.json
  */
-exports.VERSION = '1.4.9';
+exports.VERSION = '1.5.1';
 /**
  * Package name with scope
  * Used for initialization and identification

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "1.4.9",
+	"version": "1.5.1",
 	"description": "TypeScript Model Context Protocol (MCP) server boilerplate providing IP lookup tools/resources. Includes CLI support and extensible structure for connecting AI systems (LLMs) to external data sources like ip-api.com. Ideal template for creating new MCP integrations via Node.js.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -14,11 +14,12 @@
 		"mcp-server": "./dist/index.js"
 	},
 	"scripts": {
-		"build": "tsc",
+		"build": "rimraf dist && tsc",
 		"prepare": "npm run build && chmod +x dist/index.js",
-		"postinstall": "chmod +x dist/index.js || true",
+		"postinstall": "node scripts/ensure-executable.js || true",
 		"test": "jest",
 		"test:coverage": "jest --coverage",
+		"test:cli": "jest src/cli/.*\\.cli\\.test\\.ts --runInBand --testTimeout=60000",
 		"lint": "eslint src --ext .ts --config eslint.config.mjs",
 		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
 		"publish:npm": "npm publish",
@@ -70,6 +71,7 @@
 		"nodemon": "^3.1.10",
 		"npm-check-updates": "^18.0.1",
 		"prettier": "^3.5.3",
+		"rimraf": "^6.0.1",
 		"semantic-release": "^24.2.3",
 		"ts-jest": "^29.3.2",
 		"ts-node": "^10.9.2",
@@ -84,7 +86,7 @@
 		"@modelcontextprotocol/sdk": "^1.11.0",
 		"commander": "^13.1.0",
 		"dotenv": "^16.5.0",
-		"zod": "^3.24.3"
+		"zod": "^3.24.4"
 	},
 	"directories": {
 		"example": "examples"

package/package.json.bak

@@ -1,6 +1,6 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "1.4.8",
+	"version": "1.5.0",
 	"description": "TypeScript Model Context Protocol (MCP) server boilerplate providing IP lookup tools/resources. Includes CLI support and extensible structure for connecting AI systems (LLMs) to external data sources like ip-api.com. Ideal template for creating new MCP integrations via Node.js.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -14,11 +14,12 @@
 		"mcp-server": "./dist/index.js"
 	},
 	"scripts": {
-		"build": "tsc",
+		"build": "rimraf dist && tsc",
 		"prepare": "npm run build && chmod +x dist/index.js",
-		"postinstall": "chmod +x dist/index.js || true",
+		"postinstall": "node scripts/ensure-executable.js || true",
 		"test": "jest",
 		"test:coverage": "jest --coverage",
+		"test:cli": "jest src/cli/.*\\.cli\\.test\\.ts --runInBand --testTimeout=60000",
 		"lint": "eslint src --ext .ts --config eslint.config.mjs",
 		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
 		"publish:npm": "npm publish",
@@ -70,6 +71,7 @@
 		"nodemon": "^3.1.10",
 		"npm-check-updates": "^18.0.1",
 		"prettier": "^3.5.3",
+		"rimraf": "^6.0.1",
 		"semantic-release": "^24.2.3",
 		"ts-jest": "^29.3.2",
 		"ts-node": "^10.9.2",
@@ -84,7 +86,7 @@
 		"@modelcontextprotocol/sdk": "^1.11.0",
 		"commander": "^13.1.0",
 		"dotenv": "^16.5.0",
-		"zod": "^3.24.3"
+		"zod": "^3.24.4"
 	},
 	"directories": {
 		"example": "examples"

package/scripts/ensure-executable.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Use dynamic import meta for ESM compatibility
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.resolve(__dirname, '..');
+const entryPoint = path.join(rootDir, 'dist', 'index.js');
+
+try {
+	if (fs.existsSync(entryPoint)) {
+		// Ensure the file is executable (cross-platform)
+		const currentMode = fs.statSync(entryPoint).mode;
+		// Check if executable bits are set (user, group, or other)
+		// Mode constants differ slightly across platforms, checking broadly
+		const isExecutable =
+			currentMode & fs.constants.S_IXUSR ||
+			currentMode & fs.constants.S_IXGRP ||
+			currentMode & fs.constants.S_IXOTH;
+
+		if (!isExecutable) {
+			// Set permissions to 755 (rwxr-xr-x) if not executable
+			fs.chmodSync(entryPoint, 0o755);
+			console.log(
+				`Made ${path.relative(rootDir, entryPoint)} executable`,
+			);
+		} else {
+			// console.log(`${path.relative(rootDir, entryPoint)} is already executable`);
+		}
+	} else {
+		// console.warn(`${path.relative(rootDir, entryPoint)} not found, skipping chmod`);
+	}
+} catch (err) {
+	// console.warn(`Failed to set executable permissions: ${err.message}`);
+	// We use '|| true' in package.json, so no need to exit here
+}

package/dist/utils/constants.util.js.bak

@@ -1,24 +0,0 @@
-"use strict";
-/**
- * Application constants
- *
- * This file contains constants used throughout the application.
- * Centralizing these values makes them easier to maintain and update.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLI_NAME = exports.PACKAGE_NAME = exports.VERSION = void 0;
-/**
- * Current application version
- * This should match the version in package.json
- */
-exports.VERSION = '1.1.3';
-/**
- * Package name with scope
- * Used for initialization and identification
- */
-exports.PACKAGE_NAME = '@aashari/boilerplate-mcp-server';
-/**
- * CLI command name
- * Used for binary name and CLI help text
- */
-exports.CLI_NAME = 'mcp-boilerplate';