@aashari/boilerplate-mcp-server 1.10.4 → 1.11.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.11.0](https://github.com/aashari/boilerplate-mcp-server/compare/v1.10.5...v1.11.0) (2025-06-22)
+
+
+### Features
+
+* add Streamable HTTP transport support alongside STDIO ([aa04e01](https://github.com/aashari/boilerplate-mcp-server/commit/aa04e011b2f80ced3de024050e36ef09d3ed7b18))
+
+## [1.10.5](https://github.com/aashari/boilerplate-mcp-server/compare/v1.10.4...v1.10.5) (2025-06-02)
+
+
+### Bug Fixes
+
+* replace Unix-specific chmod with cross-platform ensure-executable script ([6733798](https://github.com/aashari/boilerplate-mcp-server/commit/6733798669eead4766627193d5ef9f1f0cf1582a))
+
 ## [1.10.4](https://github.com/aashari/boilerplate-mcp-server/compare/v1.10.3...v1.10.4) (2025-06-02)
 
 

package/README.md

@@ -7,13 +7,14 @@ A foundation for developing custom Model Context Protocol (MCP) servers in TypeS
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
 [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
 
-## Why Use This Boilerplate?
+## Features
 
-- **Production-Ready Architecture**: Follows the same pattern used in published MCP servers, with clean separation between CLI, tools, controllers, and services
-- **Type Safety**: Built with TypeScript for improved developer experience, code quality, and maintainability
-- **Working Example**: Includes fully implemented tools demonstrating the complete pattern from CLI to API integration
-- **Testing Framework**: Ready-to-use testing infrastructure for unit and CLI integration tests, with coverage reporting
-- **Complete Developer Tooling**: Pre-configured ESLint, Prettier, TypeScript, and CI/CD workflows
+- **Multiple Transport Support**: STDIO and Streamable HTTP transports
+- **Production-Ready Architecture**: Clean separation between CLI, tools, controllers, and services
+- **Type Safety**: Built with TypeScript for improved developer experience
+- **Working Example**: Fully implemented IP address lookup tools
+- **Testing Framework**: Ready-to-use testing infrastructure with coverage reporting
+- **Complete Developer Tooling**: Pre-configured ESLint, Prettier, TypeScript
 
 ## What is MCP?
 
@@ -34,13 +35,36 @@ cd boilerplate-mcp-server
 # Install dependencies
 npm install
 
-# Start development server
-npm run dev:server
+# Run in different modes:
 
-# Try the example tool
-npm run dev:cli -- get-ip-details 8.8.8.8
+# 1. CLI Mode - Execute commands directly
+npm run cli -- get-ip-details 8.8.8.8
+
+# 2. STDIO Transport - For direct AI assistant integration
+npm run mcp:stdio
+
+# 3. HTTP Transport - For web-based integrations (default)
+npm run mcp:http
+
+# 4. Development with MCP Inspector
+npm run mcp:inspect
 ```
 
+## Transport Modes
+
+### STDIO Transport
+- Traditional subprocess communication via stdin/stdout
+- Ideal for local AI assistant integrations
+- Run with: `TRANSPORT_MODE=stdio npm run build && node dist/index.js`
+
+### Streamable HTTP Transport (Default)
+- Modern HTTP-based transport with Server-Sent Events (SSE)
+- Supports multiple concurrent connections
+- Runs on port 3000 by default (configurable via PORT env var)
+- Endpoint: `http://localhost:3000/mcp`
+- Health check: `http://localhost:3000/`
+- Run with: `TRANSPORT_MODE=http npm run build && node dist/index.js`
+
 ## Architecture Overview
 
 <details>
@@ -58,6 +82,8 @@ src/
 ├── tools/            # MCP tool definitions
 │   ├── *.tool.ts     # Tool implementations
 │   └── *.types.ts    # Tool argument schemas
+├── resources/        # MCP resource definitions
+│   └── *.resource.ts # Resource implementations
 ├── types/            # Type definitions
 │   └── common.types.ts # Shared type definitions
 ├── utils/            # Shared utilities
@@ -107,40 +133,44 @@ The boilerplate follows a clean, layered architecture that promotes maintainabil
 ### Development Scripts
 
 ```bash
-# Start server in dev mode with hot-reload & inspector
-npm run dev:server
-
-# Run CLI commands in development
-npm run dev:cli -- [command] [args]
-
-# Build the project
-npm run build
+# Development
+npm run build               # Build TypeScript
+npm run clean               # Clean build artifacts
 
-# Production server
-npm start
-npm run start:server
+# Running different modes
+npm run cli -- [command]    # Run CLI commands
+npm run mcp:stdio          # Run with STDIO transport
+npm run mcp:http           # Run with HTTP transport (default)
+npm run mcp:inspect        # Run with MCP Inspector
 
-# Production CLI
-npm run start:cli -- [command] [args]
+# Development modes
+npm run dev:stdio          # STDIO with inspector
+npm run dev:http           # HTTP in development mode
 
 # Testing
 npm test                    # Run all tests
-npm test -- src/path/to/test.ts  # Run specific tests
 npm run test:coverage       # Generate coverage report
 
 # Code Quality
 npm run lint                # Run ESLint
 npm run format              # Format with Prettier
-npm run typecheck           # Check TypeScript types
 ```
 
+### Environment Variables
+
+- `TRANSPORT_MODE`: Set to `stdio` or `http` (default: `http`)
+- `PORT`: HTTP server port (default: `3000`)
+- `DEBUG`: Enable debug logging (default: `false`)
+- `IPAPI_API_TOKEN`: API token for ip-api.com (optional)
+
 ### Debugging Tools
 
 - **MCP Inspector**: Visual tool for testing your MCP tools
-  - Run server with `npm run dev:server`
-  - Open http://localhost:5173 in your browser
+  - Run server with `npm run mcp:inspect`
+  - Open the URL shown in terminal
+  - Test your tools interactively
 
-- **Server Logs**: Enable with `DEBUG=true npm run dev:server` or in config
+- **Debug Logging**: Enable with `DEBUG=true` environment variable
 
 <details>
 <summary><b>Configuration (Click to expand)</b></summary>
@@ -152,7 +182,8 @@ Create `~/.mcp/configs.json`:
   "boilerplate": {
     "environments": {
       "DEBUG": "true",
-      "ANY_OTHER_CONFIG": "value"
+      "TRANSPORT_MODE": "http",
+      "PORT": "3000"
     }
   }
 }
@@ -332,7 +363,7 @@ exampleTool.register(server);
 
 2. Update README.md with your tool documentation
 3. Build: `npm run build`
-4. Test: `npm run start:server`
+4. Test: `npm run mcp:stdio` and `npm run mcp:http`
 5. Publish: `npm publish`
 
 ## Testing Best Practices
@@ -350,4 +381,4 @@ exampleTool.register(server);
 
 - [MCP Specification](https://github.com/modelcontextprotocol/mcp-spec)
 - [Official MCP Documentation](https://www.modelcontextprotocol.ai/)
-- [TypeScript Documentation](https://www.typescriptlang.org/docs/)
+- [TypeScript Documentation](https://www.typescriptlang.org/docs/)

package/dist/index.d.ts

@@ -2,8 +2,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
  * Start the MCP server with the specified transport mode
- *
- * @param mode The transport mode to use (stdio or sse)
- * @returns Promise that resolves to the server instance when started successfully
  */
-export declare function startServer(mode?: 'stdio' | 'sse'): Promise<McpServer>;
+export declare function startServer(mode?: 'stdio' | 'http'): Promise<McpServer>;

package/dist/index.js

@@ -6,111 +6,160 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startServer = startServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const logger_util_js_1 = require("./utils/logger.util.js");
 const config_util_js_1 = require("./utils/config.util.js");
-const error_util_js_1 = require("./utils/error.util.js");
 const constants_util_js_1 = require("./utils/constants.util.js");
 const index_js_1 = require("./cli/index.js");
-// Import tools
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+// Import tools and resources
 const ipaddress_tool_js_1 = __importDefault(require("./tools/ipaddress.tool.js"));
-// Import resources
 const ipaddress_resource_js_1 = __importDefault(require("./resources/ipaddress.resource.js"));
-/**
- * Boilerplate MCP Server
- *
- * A template project for building MCP servers that follow best practices.
- * Demonstrates proper structure, logging, error handling, and MCP protocol integration.
- */
-// Create file-level logger
-const indexLogger = logger_util_js_1.Logger.forContext('index.ts');
-// Log initialization at debug level
-indexLogger.debug('Boilerplate MCP server module loaded');
+const logger = logger_util_js_1.Logger.forContext('index.ts');
 let serverInstance = null;
 let transportInstance = null;
 /**
  * Start the MCP server with the specified transport mode
- *
- * @param mode The transport mode to use (stdio or sse)
- * @returns Promise that resolves to the server instance when started successfully
  */
-async function startServer(mode = 'stdio') {
+async function startServer(mode = 'http') {
     const serverLogger = logger_util_js_1.Logger.forContext('index.ts', 'startServer');
     // Load configuration
     serverLogger.info('Starting MCP server initialization...');
     config_util_js_1.config.load();
-    serverLogger.info('Configuration loaded successfully');
-    // Enable debug logging if DEBUG is set to true
     if (config_util_js_1.config.getBoolean('DEBUG')) {
         serverLogger.debug('Debug mode enabled');
     }
-    // Log the DEBUG value to verify configuration loading
-    serverLogger.debug(`DEBUG environment variable: ${process.env.DEBUG}`);
-    serverLogger.debug(`IPAPI_API_TOKEN value exists: ${Boolean(process.env.IPAPI_API_TOKEN)}`);
-    serverLogger.debug(`Config DEBUG value: ${config_util_js_1.config.get('DEBUG')}`);
     serverLogger.info(`Initializing Boilerplate MCP server v${constants_util_js_1.VERSION}`);
     serverInstance = new mcp_js_1.McpServer({
         name: constants_util_js_1.PACKAGE_NAME,
         version: constants_util_js_1.VERSION,
     });
+    // Register tools and resources
+    serverLogger.info('Registering MCP tools and resources...');
+    ipaddress_tool_js_1.default.registerTools(serverInstance);
+    ipaddress_resource_js_1.default.registerResources(serverInstance);
+    serverLogger.debug('All tools and resources registered');
     if (mode === 'stdio') {
-        serverLogger.info('Using STDIO transport for MCP communication');
+        serverLogger.info('Using STDIO transport');
         transportInstance = new stdio_js_1.StdioServerTransport();
+        try {
+            await serverInstance.connect(transportInstance);
+            serverLogger.info('MCP server started successfully on STDIO transport');
+            setupGracefulShutdown();
+            return serverInstance;
+        }
+        catch (err) {
+            serverLogger.error('Failed to start server on STDIO transport', err);
+            process.exit(1);
+        }
     }
     else {
-        throw (0, error_util_js_1.createUnexpectedError)('SSE mode is not supported yet');
-    }
-    // Register tools
-    serverLogger.info('Registering MCP tools...');
-    ipaddress_tool_js_1.default.registerTools(serverInstance);
-    serverLogger.debug('Registered IP address tools');
-    // Register resources
-    serverLogger.info('Registering MCP resources...');
-    ipaddress_resource_js_1.default.registerResources(serverInstance);
-    serverLogger.debug('Registered IP address resources');
-    serverLogger.info('All tools and resources registered successfully');
-    try {
-        serverLogger.info(`Connecting to ${mode.toUpperCase()} transport...`);
-        await serverInstance.connect(transportInstance);
-        serverLogger.info('MCP server started successfully and ready to process requests');
+        // HTTP transport with Express
+        serverLogger.info('Using Streamable HTTP transport');
+        const app = (0, express_1.default)();
+        app.use((0, cors_1.default)());
+        app.use(express_1.default.json());
+        const mcpEndpoint = '/mcp';
+        serverLogger.debug(`MCP endpoint: ${mcpEndpoint}`);
+        // Create transport instance
+        const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+            // sessionIdGenerator is optional
+            sessionIdGenerator: undefined,
+        });
+        // Connect server to transport
+        await serverInstance.connect(transport);
+        transportInstance = transport;
+        // Handle all MCP requests
+        app.all(mcpEndpoint, (req, res) => {
+            transport
+                .handleRequest(req, res, req.body)
+                .catch((err) => {
+                serverLogger.error('Error in transport.handleRequest', err);
+                if (!res.headersSent) {
+                    res.status(500).json({
+                        error: 'Internal Server Error',
+                    });
+                }
+            });
+        });
+        // Health check endpoint
+        app.get('/', (_req, res) => {
+            res.send(`Boilerplate MCP Server v${constants_util_js_1.VERSION} is running`);
+        });
+        // Start HTTP server
+        const PORT = Number(process.env.PORT ?? 3000);
+        await new Promise((resolve) => {
+            app.listen(PORT, () => {
+                serverLogger.info(`HTTP transport listening on http://localhost:${PORT}${mcpEndpoint}`);
+                resolve();
+            });
+        });
+        setupGracefulShutdown();
         return serverInstance;
     }
-    catch (err) {
-        serverLogger.error(`Failed to start server`, err);
-        process.exit(1);
-    }
 }
 /**
- * Main entry point - this will run when executed directly
- * Determines whether to run in CLI or server mode based on command-line arguments
+ * Main entry point
  */
 async function main() {
     const mainLogger = logger_util_js_1.Logger.forContext('index.ts', 'main');
     // Load configuration
     config_util_js_1.config.load();
-    // Log the DEBUG value to verify configuration loading
-    mainLogger.debug(`DEBUG environment variable: ${process.env.DEBUG}`);
-    mainLogger.debug(`IPAPI_API_TOKEN value exists: ${Boolean(process.env.IPAPI_API_TOKEN)}`);
-    mainLogger.debug(`Config DEBUG value: ${config_util_js_1.config.get('DEBUG')}`);
-    // Check if arguments are provided (CLI mode)
+    // CLI mode - if any arguments are provided
     if (process.argv.length > 2) {
-        // CLI mode: Pass arguments to CLI runner
-        mainLogger.info('Starting in CLI mode');
+        mainLogger.info('CLI mode detected');
         await (0, index_js_1.runCli)(process.argv.slice(2));
-        mainLogger.info('CLI execution completed');
+        return;
+    }
+    // Server mode - determine transport
+    const transportMode = (process.env.TRANSPORT_MODE || 'http').toLowerCase();
+    let mode;
+    if (transportMode === 'stdio') {
+        mode = 'stdio';
+    }
+    else if (transportMode === 'http') {
+        mode = 'http';
     }
     else {
-        // MCP Server mode: Start server with default STDIO
-        mainLogger.info('Starting in server mode');
-        await startServer();
-        mainLogger.info('Server is now running');
+        mainLogger.warn(`Unknown TRANSPORT_MODE "${transportMode}", defaulting to http`);
+        mode = 'http';
     }
+    mainLogger.info(`Starting server with ${mode.toUpperCase()} transport`);
+    await startServer(mode);
 }
-// If this file is being executed directly (not imported), run the main function
+// Run main if executed directly
 if (require.main === module) {
     main().catch((err) => {
-        const indexLogger = logger_util_js_1.Logger.forContext('index.ts'); // Re-create logger for catch
-        indexLogger.error('Unhandled error in main process', err);
+        logger.error('Unhandled error in main process', err);
         process.exit(1);
     });
 }
+/**
+ * Graceful shutdown handler
+ */
+function setupGracefulShutdown() {
+    const shutdownLogger = logger_util_js_1.Logger.forContext('index.ts', 'shutdown');
+    const shutdown = async () => {
+        try {
+            shutdownLogger.info('Shutting down gracefully...');
+            if (transportInstance &&
+                'close' in transportInstance &&
+                typeof transportInstance.close === 'function') {
+                await transportInstance.close();
+            }
+            if (serverInstance && typeof serverInstance.close === 'function') {
+                await serverInstance.close();
+            }
+            process.exit(0);
+        }
+        catch (err) {
+            shutdownLogger.error('Error during shutdown', err);
+            process.exit(1);
+        }
+    };
+    ['SIGINT', 'SIGTERM'].forEach((signal) => {
+        process.on(signal, shutdown);
+    });
+}

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.10.4";
+export declare const VERSION = "1.11.0";
 /**
  * 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.10.4';
+exports.VERSION = '1.11.0';
 /**
  * Package name with scope
  * Used for initialization and identification

package/package.json

@@ -1,10 +1,9 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "1.10.4",
-	"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.",
+	"version": "1.11.0",
+	"description": "TypeScript MCP server boilerplate with STDIO and HTTP transport support, CLI tools, and extensible architecture",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
-	"_moduleNotes": "Although source code uses ESM syntax, the build output target is CommonJS to align with Node.js compatibility and patterns seen in related MCP servers. tsconfig.json's 'module': 'NodeNext' handles the input syntax, while tsc outputs CJS.",
 	"type": "commonjs",
 	"repository": {
 		"type": "git",
@@ -15,79 +14,75 @@
 	},
 	"scripts": {
 		"build": "tsc",
-		"prepare": "npm run build && chmod +x dist/index.js",
-		"postinstall": "chmod +x dist/index.js || true",
+		"prepare": "npm run build && node scripts/ensure-executable.js",
+		"postinstall": "node scripts/ensure-executable.js",
+		"clean": "rm -rf dist coverage",
 		"test": "jest",
 		"test:coverage": "jest --coverage",
 		"lint": "eslint src --ext .ts --config eslint.config.mjs",
 		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
-		"publish:npm": "npm publish",
-		"update:check": "npx npm-check-updates",
-		"update:deps": "npx npm-check-updates -u && npm install --legacy-peer-deps",
-		"update:version": "node scripts/update-version.js",
-		"dev:server": "DEBUG=true npm run build && npx @modelcontextprotocol/inspector -e DEBUG=true node dist/index.js",
-		"dev:cli": "DEBUG=true npm run build && DEBUG=true node dist/index.js",
-		"start:server": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js",
-		"start:cli": "npm run build && node dist/index.js"
+		"cli": "npm run build && node dist/index.js",
+		"mcp:stdio": "TRANSPORT_MODE=stdio npm run build && node dist/index.js",
+		"mcp:http": "TRANSPORT_MODE=http npm run build && node dist/index.js",
+		"mcp:inspect": "TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp",
+		"dev:stdio": "npm run build && npx @modelcontextprotocol/inspector -e TRANSPORT_MODE=stdio -e DEBUG=true node dist/index.js",
+		"dev:http": "DEBUG=true TRANSPORT_MODE=http npm run build && node dist/index.js"
 	},
 	"keywords": [
 		"mcp",
+		"model-context-protocol",
 		"typescript",
 		"claude",
 		"anthropic",
 		"ai",
+		"llm",
 		"boilerplate",
 		"server",
-		"model-context-protocol",
-		"tools",
-		"resources",
-		"tooling",
-		"ai-integration",
-		"mcp-server",
-		"llm",
-		"ai-connector",
-		"external-tools",
+		"stdio",
+		"http",
+		"streamable",
 		"cli",
-		"mcp-inspector"
+		"mcp-server"
 	],
-	"author": "",
+	"author": "Andi Ashari",
 	"license": "ISC",
+	"engines": {
+		"node": ">=18.0.0"
+	},
 	"devDependencies": {
-		"@eslint/js": "^9.28.0",
+		"@eslint/js": "^9.29.0",
 		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/exec": "^7.1.0",
 		"@semantic-release/git": "^10.0.1",
 		"@semantic-release/github": "^11.0.3",
 		"@semantic-release/npm": "^12.0.1",
-		"@types/jest": "^29.5.14",
-		"@types/node": "^22.15.29",
-		"@typescript-eslint/eslint-plugin": "^8.33.0",
-		"@typescript-eslint/parser": "^8.33.0",
-		"eslint": "^9.28.0",
+		"@types/cors": "^2.8.19",
+		"@types/express": "^5.0.3",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^24.0.3",
+		"@typescript-eslint/eslint-plugin": "^8.34.1",
+		"@typescript-eslint/parser": "^8.34.1",
+		"eslint": "^9.29.0",
 		"eslint-config-prettier": "^10.1.5",
-		"eslint-plugin-prettier": "^5.4.1",
-		"jest": "^29.7.0",
-		"nodemon": "^3.1.10",
-		"npm-check-updates": "^18.0.1",
+		"eslint-plugin-prettier": "^5.5.0",
+		"jest": "^30.0.2",
 		"prettier": "^3.5.3",
 		"semantic-release": "^24.2.5",
-		"ts-jest": "^29.3.4",
-		"ts-node": "^10.9.2",
+		"ts-jest": "^29.4.0",
 		"typescript": "^5.8.3",
-		"typescript-eslint": "^8.33.0"
-	},
-	"publishConfig": {
-		"registry": "https://registry.npmjs.org/",
-		"access": "public"
+		"typescript-eslint": "^8.34.1"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.12.1",
+		"@modelcontextprotocol/sdk": "^1.13.0",
 		"commander": "^14.0.0",
+		"cors": "^2.8.5",
 		"dotenv": "^16.5.0",
-		"zod": "^3.25.47"
+		"express": "^5.1.0",
+		"zod": "^3.25.67"
 	},
-	"directories": {
-		"example": "examples"
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/",
+		"access": "public"
 	},
 	"jest": {
 		"preset": "ts-jest",
@@ -97,18 +92,7 @@
 		],
 		"collectCoverageFrom": [
 			"src/**/*.ts",
-			"!src/**/*.test.ts",
-			"!src/**/*.spec.ts"
-		],
-		"coveragePathIgnorePatterns": [
-			"/node_modules/",
-			"/dist/",
-			"/coverage/"
-		],
-		"coverageReporters": [
-			"text",
-			"lcov",
-			"json-summary"
+			"!src/**/*.test.ts"
 		],
 		"transform": {
 			"^.+\\.tsx?$": [
@@ -123,14 +107,6 @@
 		},
 		"extensionsToTreatAsEsm": [
 			".ts"
-		],
-		"moduleFileExtensions": [
-			"ts",
-			"tsx",
-			"js",
-			"jsx",
-			"json",
-			"node"
 		]
 	}
 }

package/package.json.bak

@@ -1,10 +1,9 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "1.10.3",
-	"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.",
+	"version": "1.10.5",
+	"description": "TypeScript MCP server boilerplate with STDIO and HTTP transport support, CLI tools, and extensible architecture",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
-	"_moduleNotes": "Although source code uses ESM syntax, the build output target is CommonJS to align with Node.js compatibility and patterns seen in related MCP servers. tsconfig.json's 'module': 'NodeNext' handles the input syntax, while tsc outputs CJS.",
 	"type": "commonjs",
 	"repository": {
 		"type": "git",
@@ -15,79 +14,75 @@
 	},
 	"scripts": {
 		"build": "tsc",
-		"prepare": "npm run build && chmod +x dist/index.js",
-		"postinstall": "chmod +x dist/index.js || true",
+		"prepare": "npm run build && node scripts/ensure-executable.js",
+		"postinstall": "node scripts/ensure-executable.js",
+		"clean": "rm -rf dist coverage",
 		"test": "jest",
 		"test:coverage": "jest --coverage",
 		"lint": "eslint src --ext .ts --config eslint.config.mjs",
 		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
-		"publish:npm": "npm publish",
-		"update:check": "npx npm-check-updates",
-		"update:deps": "npx npm-check-updates -u && npm install --legacy-peer-deps",
-		"update:version": "node scripts/update-version.js",
-		"dev:server": "DEBUG=true npm run build && npx @modelcontextprotocol/inspector -e DEBUG=true node dist/index.js",
-		"dev:cli": "DEBUG=true npm run build && DEBUG=true node dist/index.js",
-		"start:server": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js",
-		"start:cli": "npm run build && node dist/index.js"
+		"cli": "npm run build && node dist/index.js",
+		"mcp:stdio": "TRANSPORT_MODE=stdio npm run build && node dist/index.js",
+		"mcp:http": "TRANSPORT_MODE=http npm run build && node dist/index.js",
+		"mcp:inspect": "TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp",
+		"dev:stdio": "npm run build && npx @modelcontextprotocol/inspector -e TRANSPORT_MODE=stdio -e DEBUG=true node dist/index.js",
+		"dev:http": "DEBUG=true TRANSPORT_MODE=http npm run build && node dist/index.js"
 	},
 	"keywords": [
 		"mcp",
+		"model-context-protocol",
 		"typescript",
 		"claude",
 		"anthropic",
 		"ai",
+		"llm",
 		"boilerplate",
 		"server",
-		"model-context-protocol",
-		"tools",
-		"resources",
-		"tooling",
-		"ai-integration",
-		"mcp-server",
-		"llm",
-		"ai-connector",
-		"external-tools",
+		"stdio",
+		"http",
+		"streamable",
 		"cli",
-		"mcp-inspector"
+		"mcp-server"
 	],
-	"author": "",
+	"author": "Andi Ashari",
 	"license": "ISC",
+	"engines": {
+		"node": ">=18.0.0"
+	},
 	"devDependencies": {
-		"@eslint/js": "^9.28.0",
+		"@eslint/js": "^9.29.0",
 		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/exec": "^7.1.0",
 		"@semantic-release/git": "^10.0.1",
 		"@semantic-release/github": "^11.0.3",
 		"@semantic-release/npm": "^12.0.1",
-		"@types/jest": "^29.5.14",
-		"@types/node": "^22.15.29",
-		"@typescript-eslint/eslint-plugin": "^8.33.0",
-		"@typescript-eslint/parser": "^8.33.0",
-		"eslint": "^9.28.0",
+		"@types/cors": "^2.8.19",
+		"@types/express": "^5.0.3",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^24.0.3",
+		"@typescript-eslint/eslint-plugin": "^8.34.1",
+		"@typescript-eslint/parser": "^8.34.1",
+		"eslint": "^9.29.0",
 		"eslint-config-prettier": "^10.1.5",
-		"eslint-plugin-prettier": "^5.4.1",
-		"jest": "^29.7.0",
-		"nodemon": "^3.1.10",
-		"npm-check-updates": "^18.0.1",
+		"eslint-plugin-prettier": "^5.5.0",
+		"jest": "^30.0.2",
 		"prettier": "^3.5.3",
 		"semantic-release": "^24.2.5",
-		"ts-jest": "^29.3.4",
-		"ts-node": "^10.9.2",
+		"ts-jest": "^29.4.0",
 		"typescript": "^5.8.3",
-		"typescript-eslint": "^8.33.0"
-	},
-	"publishConfig": {
-		"registry": "https://registry.npmjs.org/",
-		"access": "public"
+		"typescript-eslint": "^8.34.1"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.12.1",
+		"@modelcontextprotocol/sdk": "^1.13.0",
 		"commander": "^14.0.0",
+		"cors": "^2.8.5",
 		"dotenv": "^16.5.0",
-		"zod": "^3.25.47"
+		"express": "^5.1.0",
+		"zod": "^3.25.67"
 	},
-	"directories": {
-		"example": "examples"
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/",
+		"access": "public"
 	},
 	"jest": {
 		"preset": "ts-jest",
@@ -97,18 +92,7 @@
 		],
 		"collectCoverageFrom": [
 			"src/**/*.ts",
-			"!src/**/*.test.ts",
-			"!src/**/*.spec.ts"
-		],
-		"coveragePathIgnorePatterns": [
-			"/node_modules/",
-			"/dist/",
-			"/coverage/"
-		],
-		"coverageReporters": [
-			"text",
-			"lcov",
-			"json-summary"
+			"!src/**/*.test.ts"
 		],
 		"transform": {
 			"^.+\\.tsx?$": [
@@ -123,14 +107,6 @@
 		},
 		"extensionsToTreatAsEsm": [
 			".ts"
-		],
-		"moduleFileExtensions": [
-			"ts",
-			"tsx",
-			"js",
-			"jsx",
-			"json",
-			"node"
 		]
 	}
-}
+}