create-mcp-kit 0.0.3 → 0.0.4

package/dist/index.js

@@ -1,15 +1,32 @@
 #!/usr/bin/env node
-import * as clack from "@clack/prompts";
-import pc from "picocolors";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
-import { stat } from "fs/promises";
-import { createProject, installDependencies, sleep } from "@mcp-tool-kit/shared";
+import * as clack from "@clack/prompts";
+import pc from "picocolors";
+import gradient from "gradient-string";
+import { createProject, fileExists, installDependencies, sleep } from "@mcp-tool-kit/shared";
 
 //#region src/index.ts
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-clack.intro(pc.inverse(" create-mcp-kit "));
+clack.intro(gradient([
+	{
+		color: "#a855f7",
+		pos: 0
+	},
+	{
+		color: "#3b82f6",
+		pos: .4
+	},
+	{
+		color: "#06b6d4",
+		pos: .8
+	},
+	{
+		color: "#10b981",
+		pos: 1
+	}
+])("MCP Kit - The Modern Context Protocol Builder"));
 const group = await clack.group({
 	type: () => clack.select({
 		message: "Project type:",
@@ -37,33 +54,100 @@ const group = await clack.group({
 		message: "Project template:",
 		options: [{
 			value: "standard",
-			label: pc.magenta("Standard")
+			label: pc.magenta("Standard (recommended)")
+		}, {
+			value: "custom",
+			label: pc.blue("Custom")
 		}]
 	}),
+	transports: () => {
+		return clack.multiselect({
+			message: "Project Transport Type:",
+			required: true,
+			initialValues: ["stdio"],
+			options: [
+				{
+					value: "stdio",
+					label: pc.magenta("STDIO")
+				},
+				{
+					value: "streamable",
+					label: pc.blue("Streamable HTTP")
+				},
+				{
+					value: "sse",
+					label: pc.yellow("SSE")
+				}
+			]
+		});
+	},
+	plugins: ({ results }) => {
+		if (results.template !== "custom") return Promise.resolve([
+			"github-action",
+			"vitest",
+			"inspector",
+			"style",
+			"commitlint",
+			"changelog"
+		]);
+		return clack.multiselect({
+			message: "Project plugins:",
+			required: false,
+			options: [
+				{
+					value: "github-action",
+					label: pc.magenta("GitHub Action")
+				},
+				{
+					value: "vitest",
+					label: pc.green("Vitest")
+				},
+				{
+					value: "inspector",
+					label: pc.blue("Inspector")
+				},
+				{
+					value: "style",
+					label: pc.white("ESLint + Prettier + Lint-staged")
+				},
+				{
+					value: "commitlint",
+					label: pc.gray("Commitlint")
+				},
+				{
+					value: "changelog",
+					label: pc.blueBright("Changelog")
+				}
+			]
+		});
+	},
 	install: () => clack.confirm({ message: "Do you want to install dependencies?" })
 }, { onCancel: () => {
 	clack.cancel("Operation cancelled.");
 	process.exit(0);
 } });
-const templatePath = join(__dirname, "../template", `${group.template}-${group.language}`);
+const templatePath = join(__dirname, "../template", `${group.type}-${group.template}-${group.language}`);
 const targetPath = resolve(process.cwd(), group.name);
-try {
-	await stat(templatePath);
-} catch {
+if (!await fileExists(templatePath)) {
 	clack.log.error(`Template not found: ${templatePath}`);
 	process.exit(1);
 }
-try {
-	await stat(targetPath);
+if (await fileExists(targetPath)) {
 	clack.log.error(`Directory ${group.name} already exists`);
 	process.exit(1);
-} catch {}
+}
 {
 	const createSpinner = clack.spinner();
 	createSpinner.start("Creating project...");
 	await sleep(100);
 	try {
-		await createProject(targetPath, templatePath, { projectName: group.name });
+		await createProject(targetPath, templatePath, {
+			projectName: group.name,
+			year: (/* @__PURE__ */ new Date()).getFullYear().toString(),
+			transports: group.transports,
+			plugins: group.plugins,
+			components: []
+		});
 	} catch (error) {
 		createSpinner.stop("Failed to create project");
 		clack.log.error(error.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mcp-kit",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "create mcp tool kit",
   "type": "module",
   "author": "zhensherlock",
@@ -40,8 +40,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
+    "gradient-string": "^3.0.0",
+    "handlebars": "^4.7.8",
     "picocolors": "^1.1.1",
-    "@mcp-tool-kit/shared": "^0.0.4"
+    "@mcp-tool-kit/shared": "^0.0.5"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.17.1",

package/template/{standard-js/_prettierrc → server-standard-js/.prettierrc.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'style')}}
 {
   "tabWidth": 2,
   "printWidth": 120,
@@ -9,3 +10,4 @@
   "jsxBracketSameLine": false,
   "arrowParens": "avoid"
 }
+{{/if}}

package/template/{standard-js/LICENSE → server-standard-js/LICENSE.hbs}

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) {{YEAR}} {{PROJECT_NAME}}
+Copyright (c) {{year}} {{projectName}}
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/template/{standard-ts/_github/workflows/build.yml → server-standard-js/_github/workflows/build.yml.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'github-action')}}
 name: build
 
 on:
@@ -7,7 +8,7 @@ on:
 
 jobs:
   build:
-    if: github.repository == '{{PROJECT_NAME}}'
+    if: github.repository == '{{projectName}}'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -35,3 +36,4 @@ jobs:
 
       - name: Coveralls
         uses: coverallsapp/github-action@v2
+{{/if}}

package/template/{standard-ts/_github/workflows/npm-publish.yml → server-standard-js/_github/workflows/npm-publish.yml.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'github-action')}}
 name: npm-publish
 
 on:
@@ -6,7 +7,7 @@ on:
 
 jobs:
   build:
-    if: github.repository == '{{PROJECT_NAME}}'
+    if: github.repository == '{{projectName}}'
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -37,3 +38,4 @@ jobs:
         run: npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{secrets.npm_token}}
+{{/if}}

package/template/server-standard-js/_husky/commit-msg.hbs

@@ -0,0 +1,3 @@
+{{#if (includes plugins 'commitlint')}}
+npx --no-install commitlint --edit $1
+{{/if}}

package/template/server-standard-js/_husky/pre-commit.hbs

@@ -0,0 +1,3 @@
+{{#if (includes plugins 'style')}}
+npx lint-staged
+{{/if}}

package/template/{standard-ts/changelog-option.js → server-standard-js/changelog-option.js.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'changelog')}}
 import compareFunc from 'compare-func'
 
 export default {
@@ -85,3 +86,4 @@ export default {
     notesSort: compareFunc,
   },
 }
+{{/if}}

package/template/{standard-js/commitlint.config.js → server-standard-js/commitlint.config.js.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'commitlint')}}
 export default {
   extends: ['@commitlint/config-conventional'],
   rules: {
@@ -23,3 +24,4 @@ export default {
     'subject-case': [0],
   },
 }
+{{/if}}

package/template/{standard-js/eslint.config.js → server-standard-js/eslint.config.js.hbs}

@@ -1,13 +1,18 @@
+{{#if (includes plugins 'style')}}
 import importPlugin from 'eslint-plugin-import'
 import prettierPlugin from 'eslint-plugin-prettier'
 import globals from 'globals'
 
 export default [
   {
-    ignores: ['**/build', '**/node_modules', '**/.*', '**/*.d.ts', '.husky/'],
+    ignores: ['**/build', '**/node_modules', '**/.*', '.husky/'],
   },
   {
+  {{#if (includes plugins 'vitest')}}
     files: ['src/**/*.js', 'tests/**/*.js'],
+  {{else}}
+    files: ['src/**/*.js'],
+  {{/if}}
   },
   {
     languageOptions: {
@@ -40,3 +45,4 @@ export default [
     },
   },
 ]
+{{/if}}

package/template/{standard-js/jsconfig.json → server-standard-js/jsconfig.json.hbs}

@@ -12,6 +12,10 @@
       "@/*": ["./src/*"]
     }
   },
+{{#if (includes plugins 'vitest')}}
   "include": ["src", "tests", "vitest.setup.js", "vitest.config.js"],
+{{else}}
+  "include": ["src"],
+{{/if}}
   "exclude": ["node_modules"]
 }

package/template/{standard-js/lint-staged.config.js → server-standard-js/lint-staged.config.js.hbs}

@@ -1,3 +1,5 @@
+{{#if (includes plugins 'style')}}
 export default {
   'src/**/*.js': ['npx eslint'],
 }
+{{/if}}

package/template/{standard-js/package.json → server-standard-js/package.json.hbs}

@@ -1,12 +1,12 @@
 {
-  "name": "{{PROJECT_NAME}}",
+  "name": "{{projectName}}",
   "version": "0.0.0",
-  "description": "{{PROJECT_NAME}}",
+  "description": "{{projectName}}",
   "author": "zhensherlock",
   "type": "module",
   "license": "MIT",
   "bin": {
-    "{{PROJECT_NAME}}": "./build/index.js"
+    "{{projectName}}": "./build/index.js"
   },
   "files": [
     "build",
@@ -15,48 +15,83 @@
   ],
   "main": "build/index.js",
   "scripts": {
-    "prepare": "husky",
+{{#if (includes plugins 'style')}}
     "lint": "npx eslint \"src/**/*.js\"",
+{{/if}}
     "build": "cross-env NODE_ENV=production node scripts/build.js",
+{{#if (and (includes transports 'stdio') (or (includes transports 'streamable') (includes transports 'sse')))}}
     "dev": "npm run dev:stdio",
     "dev:stdio": "cross-env NODE_ENV=local node scripts/dev.js",
+{{else if (includes transports 'web')}}
+    "dev": "npm run dev:stdio",
+    "dev:stdio": "cross-env NODE_ENV=local node scripts/dev.js",
+{{else}}
+    "dev": "npm run dev:web",
     "dev:web": "cross-env NODE_ENV=local TRANSPORT=web node scripts/dev.js",
+{{/if}}
+{{#if (includes plugins 'vitest')}}
     "test": "vitest run",
     "coverage": "rimraf coverage && npm run test && c8 report --reporter=lcov --reporter=html",
-    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0 -n changelog-option.js"
+{{/if}}
+{{#if (includes plugins 'changelog')}}
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0 -n changelog-option.js",
+{{/if}}
+    "prepare": "husky"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.1",
-    "cors": "^2.8.5",
     "dotenv": "^17.2.1",
+{{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
     "express": "^5.1.0",
     "nanoid": "^5.1.5",
-    "node-fetch": "^3.3.2",
+{{/if}}
     "yargs": "^17.7.2",
     "zod": "^3.25.76"
   },
   "devDependencies": {
+{{#if (includes plugins 'commitlint')}}
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
+{{/if}}
+{{#if (includes plugins 'inspector')}}
     "@modelcontextprotocol/inspector": "^0.16.2",
+{{/if}}
+{{#if (includes plugins 'vitest')}}
     "@vitest/coverage-v8": "^3.2.4",
     "c8": "^10.1.3",
+{{/if}}
+{{#if (includes plugins 'changelog')}}
     "compare-func": "^2.0.0",
+{{/if}}
     "concurrently": "^9.2.0",
+{{#if (includes plugins 'changelog')}}
     "conventional-changelog-angular": "^8.0.0",
     "conventional-changelog-cli": "^5.0.0",
+{{/if}}
     "cross-env": "^10.0.0",
     "esbuild": "^0.25.8",
+{{#if (includes plugins 'style')}}
     "eslint": "^9.32.0",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.3",
     "globals": "^16.3.0",
+{{/if}}
     "husky": "^9.1.7",
+{{#if (includes plugins 'style')}}
     "lint-staged": "^16.1.4",
+{{/if}}
+{{#if (includes plugins 'vitest')}}
     "nyc": "^17.1.0",
+{{/if}}
+{{#if (includes plugins 'style')}}
     "prettier": "^3.6.2",
-    "rimraf": "^6.0.1",
+{{/if}}
+{{#if (includes plugins 'inspector')}}
     "tree-kill": "^1.2.2",
-    "vitest": "^3.2.4"
+{{/if}}
+{{#if (includes plugins 'vitest')}}
+    "vitest": "^3.2.4",
+{{/if}}
+    "rimraf": "^6.0.1"
   }
 }

package/template/{standard-js/scripts/base.js → server-standard-js/scripts/base.js.hbs}

@@ -1,16 +1,22 @@
 import path from 'path'
 import { fileURLToPath } from 'url'
 import { promises as fs } from 'fs'
+{{#if (includes plugins 'inspector')}}
 import { spawn } from 'child_process'
+{{/if}}
 import { rimraf } from 'rimraf'
+{{#if (includes plugins 'inspector')}}
 import kill from 'tree-kill'
+{{/if}}
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const isProd = process.env.NODE_ENV === 'production'
 const isDev = process.env.NODE_ENV === 'local'
+{{#if (includes plugins 'inspector')}}
 let inspectorProcess = null
 let webProcess = null
 let autoOpenBrowser = true
+{{/if}}
 
 /** @type {import('esbuild').BuildOptions} */
 export const config = {
@@ -21,7 +27,7 @@ export const config = {
   sourcemap: isDev,
   minify: isProd,
   platform: 'node',
-  external: ['yargs', 'node-fetch', 'cors', 'express', 'nanoid', 'zod', 'dotenv', '@modelcontextprotocol/sdk'],
+  external: ['yargs', 'express', 'nanoid', 'zod', 'dotenv', '@modelcontextprotocol/sdk'],
   alias: {
     '@': path.resolve(__dirname, '../src'),
   },
@@ -53,11 +59,10 @@ const after = async result => {
     } else {
       console.error('❌ Rebuild failed')
     }
-
+{{#if (includes plugins 'inspector')}}
     console.log('🚀 Starting @modelcontextprotocol/inspector...')
     if (inspectorProcess) {
       kill(inspectorProcess.pid, 'SIGINT')
-      // inspectorProcess.kill('SIGINT')
     }
     inspectorProcess = spawn('npx', ['@modelcontextprotocol/inspector', 'build/index.js'], {
       stdio: 'inherit',
@@ -78,5 +83,6 @@ const after = async result => {
         stdio: 'inherit',
       })
     }
+{{/if}}
   }
 }

package/template/{standard-js/src/index.js → server-standard-js/src/index.js.hbs}

@@ -1,28 +1,39 @@
 #!/usr/bin/env node
 import yargs from 'yargs'
 import { hideBin } from 'yargs/helpers'
+{{#if (and (includes transports 'stdio') (or (includes transports 'streamable') (includes transports 'sse')))}}
 import { startWebServer, startStdioServer } from './services/index.js'
+{{else if (includes transports 'stdio')}}
+import { startStdioServer } from './services/index.js'
+{{else}}
+import { startWebServer } from './services/index.js'
+{{/if}}
 import { getOptions } from './utils/index.js'
 import 'dotenv/config'
 import pkg from '../package.json' with { type: 'json' }
 
-const name = 'node-mcp-server'
+const name = '{{projectName}}'
 
 const argv = await yargs()
   .scriptName(name)
   .usage('$0 <command> [options]')
+{{#if (includes transports 'stdio')}}
   .command(
     'stdio',
     'Start the server using the stdio transport protocol.',
     () => {},
     argv => startServer('stdio', argv),
   )
+{{/if}}
+{{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
   .command(
     'web',
     'Start the web server transport protocol.',
     () => {},
     argv => startServer('web', argv),
   )
+{{/if}}
+{{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
   .options({
     port: {
       describe: 'Specify the port for SSE or streamable transport (default: 8401)',
@@ -30,11 +41,16 @@ const argv = await yargs()
       default: process.env.PORT || '8401',
     },
   })
+{{/if}}
   .help()
   .parse(hideBin(process.argv))
 
 if (!argv._[0]) {
+{{#if (includes transports 'stdio')}}
   startServer('stdio', argv)
+{{else}}
+  startServer('web', argv)
+{{/if}}
 }
 
 async function startServer(mode, argv) {
@@ -42,9 +58,19 @@ async function startServer(mode, argv) {
     name,
     version: pkg.version,
   })
+  {{#if (and (includes transports 'stdio') (or (includes transports 'streamable') (includes transports 'sse')))}}
   if (mode === 'stdio') {
     startStdioServer(options).catch(console.error)
   } else if (mode === 'web') {
     startWebServer(options).catch(console.error)
   }
+  {{else if (includes transports 'stdio')}}
+  if (mode === 'stdio') {
+    startStdioServer(options).catch(console.error)
+  }
+  {{else}}
+  if (mode === 'web') {
+    startWebServer(options).catch(console.error)
+  }
+  {{/if}}
 }

package/template/{standard-js/src/services/index.js → server-standard-js/src/services/index.js.hbs}

@@ -2,8 +2,12 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { registerTools } from '../tools/index.js'
 import { registerResources } from '../resources/index.js'
 import { registerPrompts } from '../prompts/index.js'
+{{#if (includes transports 'stdio')}}
 import { stdioServer } from './stdio.js'
+{{/if}}
+{{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
 import { webServer } from './web.js'
+{{/if}}
 
 const createServer = options => {
   const server = new McpServer({
@@ -15,13 +19,17 @@ const createServer = options => {
   registerPrompts(server)
   return server
 }
+{{#if (includes transports 'stdio')}}
 
 export async function startStdioServer(options) {
   const server = createServer(options)
   await stdioServer(server)
 }
+{{/if}}
+{{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
 
 export async function startWebServer(options) {
   const server = createServer(options)
   await webServer(server, options)
 }
+{{/if}}

package/template/{standard-js/src/services/stdio.js → server-standard-js/src/services/stdio.js.hbs}

@@ -1,6 +1,8 @@
+{{#if (includes transports 'stdio')}}
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 export async function stdioServer(server) {
   const transport = new StdioServerTransport()
   await server.connect(transport)
 }
+{{/if}}

package/template/{standard-js/src/services/web.js → server-standard-js/src/services/web.js.hbs}

@@ -1,17 +1,30 @@
-import { nanoid } from 'nanoid'
+{{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
+  {{#if (includes transports 'streamable')}}
+  import { nanoid } from 'nanoid'
+  {{/if}}
 import express from 'express'
+  {{#if (includes transports 'streamable')}}
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js'
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'
+  {{/if}}
+  {{#if (includes transports 'sse')}}
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'
+  {{/if}}
 
 export async function webServer(server, options) {
   const app = express()
   app.use(express.json())
 
   const transports = {
+    {{#if (includes transports 'streamable')}}
     streamable: {},
+    {{/if}}
+    {{#if (includes transports 'sse')}}
     sse: {},
+    {{/if}}
   }
+  {{#if (includes transports 'streamable')}}
+
   app.post('/mcp', async (req, res) => {
     const sessionId = req.headers['mcp-session-id']
     let transport
@@ -61,6 +74,8 @@ export async function webServer(server, options) {
   app.get('/mcp', handleSessionRequest)
 
   app.delete('/mcp', handleSessionRequest)
+  {{/if}}
+  {{#if (includes transports 'sse')}}
 
   app.get('/sse', async (req, res) => {
     const transport = new SSEServerTransport('/messages', res)
@@ -83,6 +98,8 @@ export async function webServer(server, options) {
     }
   })
 
+  {{/if}}
   app.listen(options.port)
-  console.log(`MCP server started on port ${options.port}. SSE endpoint: /sse, streamable endpoint: /mcp`)
+  console.log(`MCP server started on port ${options.port}.{{#if (includes transports 'sse')}} SSE endpoint: /sse{{/if}}{{#if (includes transports 'streamable')}} streamable endpoint: /mcp{{/if}}`)
 }
+{{/if}}

package/template/{standard-ts/tests/prompts/index.test.ts → server-standard-js/tests/prompts/index.test.js.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { describe, expect, test } from 'vitest'
 
 describe('echoPrompt', () => {
@@ -22,3 +23,4 @@ describe('echoPrompt', () => {
     })
   })
 })
+{{/if}}

package/template/{standard-ts/tests/resources/index.test.ts → server-standard-js/tests/resources/index.test.js.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { describe, expect, test } from 'vitest'
 
 describe('searchResource', () => {
@@ -16,3 +17,4 @@ describe('searchResource', () => {
     })
   })
 })
+{{/if}}

package/template/{standard-ts/tests/tools/index.test.ts → server-standard-js/tests/tools/index.test.js.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { describe, expect, test } from 'vitest'
 
 describe('getDataTool', () => {
@@ -40,3 +41,4 @@ describe('getDataTool', () => {
     })
   })
 })
+{{/if}}

package/template/{standard-js/vitest.config.js → server-standard-js/vitest.config.js.hbs}

@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
@@ -8,3 +9,4 @@ export default defineConfig({
     },
   },
 })
+{{/if}}