feat: update server-standard-ts template with conditional plugin support

zhensherlock · zhensherlock · commit 00b0e28bdd67 · 2025-08-07T18:25:53.000+08:00
diff --git a/.changeset/purple-plums-nail.md b/.changeset/purple-plums-nail.md
@@ -0,0 +1,5 @@
+---
+'create-mcp-kit': patch
+---
+
+feat: update server-standard-ts template with conditional plugin support
diff --git a/packages/create-mcp-kit/template/server-standard-ts/.prettierrc.hbs b/packages/create-mcp-kit/template/server-standard-ts/.prettierrc.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'style')}}
 {
   "tabWidth": 2,
   "printWidth": 120,
@@ -9,3 +10,4 @@
   "jsxBracketSameLine": false,
   "arrowParens": "avoid"
 }
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/_github/workflows/build.yml.hbs b/packages/create-mcp-kit/template/server-standard-ts/_github/workflows/build.yml.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'github-action')}}
 name: build
 
 on:
@@ -35,3 +36,4 @@ jobs:
 
       - name: Coveralls
         uses: coverallsapp/github-action@v2
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/_github/workflows/npm-publish.yml.hbs b/packages/create-mcp-kit/template/server-standard-ts/_github/workflows/npm-publish.yml.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'github-action')}}
 name: npm-publish
 
 on:
@@ -37,3 +38,4 @@ jobs:
         run: npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{secrets.npm_token}}
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/_husky/commit-msg b/packages/create-mcp-kit/template/server-standard-ts/_husky/commit-msg
diff --git a/packages/create-mcp-kit/template/server-standard-ts/_husky/commit-msg.hbs b/packages/create-mcp-kit/template/server-standard-ts/_husky/commit-msg.hbs
@@ -0,0 +1,3 @@
+{{#if (includes plugins 'commitlint')}}
+npx --no-install commitlint --edit $1
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/_husky/pre-commit b/packages/create-mcp-kit/template/server-standard-ts/_husky/pre-commit
diff --git a/packages/create-mcp-kit/template/server-standard-ts/_husky/pre-commit.hbs b/packages/create-mcp-kit/template/server-standard-ts/_husky/pre-commit.hbs
@@ -0,0 +1,3 @@
+{{#if (includes plugins 'style')}}
+npx lint-staged
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/changelog-option.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/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}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/commitlint.config.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/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}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/eslint.config.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/eslint.config.js.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'style')}}
 import tsParser from '@typescript-eslint/parser'
 import tsPlugin from '@typescript-eslint/eslint-plugin'
 import importPlugin from 'eslint-plugin-import'
@@ -9,7 +10,11 @@ export default [
     ignores: ['**/build', '**/node_modules', '**/.*', '**/*.d.ts', '.husky/'],
   },
   {
+  {{#if (includes plugins 'vitest')}}
     files: ['src/**/*.{js,ts}', 'tests/**/*.{js,ts}'],
+  {{else}}
+    files: ['src/**/*.{js,ts}'],
+  {{/if}}
   },
   {
     languageOptions: {
@@ -47,3 +52,4 @@ export default [
     },
   },
 ]
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/lint-staged.config.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/lint-staged.config.js.hbs
@@ -1,3 +1,5 @@
+{{#if (includes plugins 'style')}}
 export default {
   'src/**/*.{ts,js}': ['npx eslint'],
 }
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/package.json.hbs b/packages/create-mcp-kit/template/server-standard-ts/package.json.hbs
@@ -15,8 +15,9 @@
   ],
   "main": "build/index.js",
   "scripts": {
-    "prepare": "husky",
+{{#if (includes plugins 'style')}}
     "lint": "npx eslint \"src/**/*.{ts,js}\"",
+{{/if}}
     "build": "tsc --noEmit && 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",
@@ -28,9 +29,14 @@
     "dev": "npm run dev:web",
     "dev:web": "cross-env NODE_ENV=local TRANSPORT=web concurrently \"tsc --noEmit --watch\" \"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",
@@ -43,35 +49,59 @@
     "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 (or (includes transports 'streamable') (includes transports 'sse'))}}
     "@types/express": "^5.0.3",
 {{/if}}
     "@types/yargs": "^17.0.33",
+{{#if (includes plugins 'style')}}
     "@typescript-eslint/eslint-plugin": "^8.38.0",
     "@typescript-eslint/parser": "^8.38.0",
+{{/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",
+{{/if}}
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+{{#if (includes plugins 'vitest')}}
+    "vitest": "^3.2.4",
+{{/if}}
+    "rimraf": "^6.0.1"
   }
 }
diff --git a/packages/create-mcp-kit/template/server-standard-ts/scripts/base.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/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 = {
@@ -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}}
   }
 }
diff --git a/packages/create-mcp-kit/template/server-standard-ts/scripts/build.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/scripts/build.js.hbs
diff --git a/packages/create-mcp-kit/template/server-standard-ts/scripts/dev.js.hbs b/packages/create-mcp-kit/template/server-standard-ts/scripts/dev.js.hbs
diff --git a/packages/create-mcp-kit/template/server-standard-ts/src/index.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/src/index.ts.hbs
@@ -12,7 +12,7 @@ import { getOptions } from './utils'
 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)
@@ -58,19 +58,19 @@ async function startServer(mode: string, argv: ArgumentsCamelCase) {
     name,
     version: pkg.version,
   })
-  {{#if (and (includes transports 'stdio') (or (includes transports 'streamable') (includes transports 'sse')))}}
+{{#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')}}
+{{else if (includes transports 'stdio')}}
   if (mode === 'stdio') {
     startStdioServer(options).catch(console.error)
   }
-  {{else}}
+{{else}}
   if (mode === 'web') {
     startWebServer(options).catch(console.error)
   }
-  {{/if}}
+{{/if}}
 }
diff --git a/packages/create-mcp-kit/template/server-standard-ts/src/services/web.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/src/services/web.ts.hbs
@@ -1,15 +1,15 @@
 {{#if (or (includes transports 'streamable') (includes transports 'sse'))}}
-{{#if (includes transports 'streamable')}}
+  {{#if (includes transports 'streamable')}}
   import { nanoid } from 'nanoid'
-{{/if}}
+  {{/if}}
 import express from 'express'
-{{#if (includes transports 'streamable')}}
+  {{#if (includes transports 'streamable')}}
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js'
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'
-{{/if}}
-{{#if (includes transports 'sse')}}
+  {{/if}}
+  {{#if (includes transports 'sse')}}
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'
-{{/if}}
+  {{/if}}
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import type { OptionsType } from '@/types'
 
@@ -18,14 +18,14 @@ export async function webServer(server: McpServer, options: OptionsType) {
   app.use(express.json())
 
   const transports = {
-{{#if (includes transports 'streamable')}}
+  {{#if (includes transports 'streamable')}}
     streamable: {} as Record<string, StreamableHTTPServerTransport>,
-{{/if}}
-{{#if (includes transports 'sse')}}
+  {{/if}}
+  {{#if (includes transports 'sse')}}
     sse: {} as Record<string, SSEServerTransport>,
-{{/if}}
+  {{/if}}
   }
-{{#if (includes transports 'streamable')}}
+  {{#if (includes transports 'streamable')}}
 
   app.post('/mcp', async (req, res) => {
     const sessionId = req.headers['mcp-session-id'] as string | undefined
@@ -76,8 +76,8 @@ export async function webServer(server: McpServer, options: OptionsType) {
   app.get('/mcp', handleSessionRequest)
 
   app.delete('/mcp', handleSessionRequest)
-{{/if}}
-{{#if (includes transports 'sse')}}
+  {{/if}}
+  {{#if (includes transports 'sse')}}
 
   app.get('/sse', async (req, res) => {
     const transport = new SSEServerTransport('/messages', res)
@@ -100,7 +100,7 @@ export async function webServer(server: McpServer, options: OptionsType) {
     }
   })
 
-{{/if}}
+  {{/if}}
   app.listen(options.port)
   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}}`)
 }
diff --git a/packages/create-mcp-kit/template/server-standard-ts/tests/prompts/index.test.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/tests/prompts/index.test.ts.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { describe, expect, test } from 'vitest'
 
 describe('echoPrompt', () => {
@@ -22,3 +23,4 @@ describe('echoPrompt', () => {
     })
   })
 })
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/tests/resources/index.test.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/tests/resources/index.test.ts.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { describe, expect, test } from 'vitest'
 
 describe('searchResource', () => {
@@ -16,3 +17,4 @@ describe('searchResource', () => {
     })
   })
 })
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/tests/tools/index.test.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/tests/tools/index.test.ts.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import { describe, expect, test } from 'vitest'
 
 describe('getDataTool', () => {
@@ -40,3 +41,4 @@ describe('getDataTool', () => {
     })
   })
 })
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/tests/vitest-global.d.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/tests/vitest-global.d.ts.hbs
@@ -1,5 +1,7 @@
+{{#if (includes plugins 'vitest')}}
 import type { Client } from '@modelcontextprotocol/sdk/client/index.js'
 
 declare global {
   var client: Client;
 }
+{{/if}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/tsconfig.json.hbs b/packages/create-mcp-kit/template/server-standard-ts/tsconfig.json.hbs
@@ -12,6 +12,10 @@
       "@/*": ["./src/*"]
     }
   },
+{{#if (includes plugins 'vitest')}}
   "include": ["src", "tests", "vitest.setup.ts", "vitest.config.ts"],
+{{else}}
+  "include": ["src"],
+{{/if}}
   "exclude": ["node_modules"]
 }
diff --git a/packages/create-mcp-kit/template/server-standard-ts/vitest.config.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/vitest.config.ts.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}}
diff --git a/packages/create-mcp-kit/template/server-standard-ts/vitest.setup.ts.hbs b/packages/create-mcp-kit/template/server-standard-ts/vitest.setup.ts.hbs
@@ -1,3 +1,4 @@
+{{#if (includes plugins 'vitest')}}
 import 'dotenv/config'
 import { Client } from '@modelcontextprotocol/sdk/client/index.js'
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'
@@ -23,3 +24,4 @@ const client = new Client({
 await client.connect(serverParams)
 
 global.client = client
+{{/if}}

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'create-mcp-kit': patch
 +---
++
 +feat: update server-standard-ts template with conditional plugin support
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+{{#if (includes plugins 'style')}}`
`1`	`2`	`{`
`2`	`3`	`"tabWidth": 2,`
`3`	`4`	`"printWidth": 120,`
`@@ -9,3 +10,4 @@`
`9`	`10`	`"jsxBracketSameLine": false,`
`10`	`11`	`"arrowParens": "avoid"`
`11`	`12`	`}`
	`13`	`+{{/if}}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{{#if (includes plugins 'commitlint')}}`
	`2`	`+npx --no-install commitlint --edit $1`
	`3`	`+{{/if}}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{{#if (includes plugins 'style')}}`
	`2`	`+npx lint-staged`
	`3`	`+{{/if}}`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+{{#if (includes plugins 'changelog')}}`
`1`	`2`	`import compareFunc from 'compare-func'`
`2`	`3`
`3`	`4`	`export default {`
`@@ -85,3 +86,4 @@ export default {`
`85`	`86`	`notesSort: compareFunc,`
`86`	`87`	`},`
`87`	`88`	`}`
	`89`	`+{{/if}}`