create-mcp-kit 0.0.2 → 0.0.3

package/README.md

@@ -1,6 +1,12 @@
 # create-mcp-kit
 A CLI tool to create MCP (Model Context Protocol) applications with ease.
 
+[![][npm-release-shield]][npm-release-link]
+[![][codecov-shield]][codecov-link]
+[![][github-release-date-shield]][github-release-date-link]
+[![][github-action-build-shield]][github-action-build-link]
+[![][github-license-shield]][github-license-link]
+
 ## Features
 - 🚀 Quick project scaffolding
 - 📦 TypeScript support out of the box
@@ -123,3 +129,14 @@ This project exists thanks to all the people who contribute.
 ## License
 
 [MIT](LICENSE) © MichaelSun
+
+[npm-release-link]: https://www.npmjs.com/package/create-mcp-kit
+[npm-release-shield]: https://img.shields.io/npm/v/create-mcp-kit?color=1677FF&labelColor=black&logo=npm&logoColor=white&style=flat-square
+[codecov-link]: https://coveralls.io/github/my-mcp-hub/mcp-kit?branch=main
+[codecov-shield]: https://img.shields.io/coverallsCoverage/github/my-mcp-hub/mcp-kit?color=1677FF&labelColor=black&style=flat-square&logo=codecov&logoColor=white
+[github-release-date-link]: https://github.com/my-mcp-hub/mcp-kit/releases
+[github-release-date-shield]: https://img.shields.io/github/release-date/my-mcp-hub/mcp-kit?color=1677FF&labelColor=black&style=flat-square
+[github-action-build-link]: https://github.com/my-mcp-hub/mcp-kit/actions/workflows/build.yml
+[github-action-build-shield]: https://img.shields.io/github/actions/workflow/status/my-mcp-hub/mcp-kit/build.yml?branch=main&color=1677FF&label=build&labelColor=black&logo=githubactions&logoColor=white&style=flat-square
+[github-license-link]: https://github.com/my-mcp-hub/mcp-kit/blob/main/LICENSE
+[github-license-shield]: https://img.shields.io/github/license/my-mcp-hub/mcp-kit?color=1677FF&labelColor=black&style=flat-square

package/dist/index.js

@@ -28,6 +28,9 @@ const group = await clack.group({
 		options: [{
 			value: "ts",
 			label: pc.magenta("TypeScript")
+		}, {
+			value: "js",
+			label: pc.blue("JavaScript")
 		}]
 	}),
 	template: () => clack.select({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mcp-kit",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "create mcp tool kit",
   "type": "module",
   "author": "zhensherlock",
@@ -41,7 +41,7 @@
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "picocolors": "^1.1.1",
-    "@mcp-tool-kit/shared": "^0.0.3"
+    "@mcp-tool-kit/shared": "^0.0.4"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.17.1",

package/template/standard-js/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{YEAR}} {{PROJECT_NAME}}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/template/standard-js/_env

@@ -0,0 +1 @@
+PORT=8401

package/template/standard-js/_github/workflows/build.yml

@@ -0,0 +1,37 @@
+name: build
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    if: github.repository == '{{PROJECT_NAME}}'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install Package
+        run: npm i
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Build Package
+        run: npm run build
+
+      - name: Test Package
+        run: npm run coverage
+
+      - name: Coveralls
+        uses: coverallsapp/github-action@v2

package/template/standard-js/_github/workflows/npm-publish.yml

@@ -0,0 +1,39 @@
+name: npm-publish
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    if: github.repository == '{{PROJECT_NAME}}'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org/
+          cache: npm
+
+      - name: Install Package
+        run: npm i
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Build Package
+        run: npm run build
+
+      - name: Publish NPM Package
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/template/standard-js/_gitignore

@@ -0,0 +1,112 @@
+.DS_Store
+.idea/
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+#.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and *not* Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+/docs/.vitepress/cache/
+
+stats.html
+
+build/

package/template/standard-js/_husky/commit-msg

@@ -0,0 +1 @@
+npx --no-install commitlint --edit $1

package/template/standard-js/_husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/template/standard-js/_nvmrc

@@ -0,0 +1 @@
+v22

package/template/standard-js/_prettierrc

@@ -0,0 +1,11 @@
+{
+  "tabWidth": 2,
+  "printWidth": 120,
+  "useTabs": false,
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "jsxBracketSameLine": false,
+  "arrowParens": "avoid"
+}

package/template/standard-js/changelog-option.js

@@ -0,0 +1,87 @@
+import compareFunc from 'compare-func'
+
+export default {
+  writerOpts: {
+    transform: (commit, context) => {
+      let discard = true
+      const issues = []
+
+      const newCommit = {
+        ...commit,
+        notes: commit.notes.map(note => ({
+          ...note,
+          title: 'BREAKING CHANGES',
+        })),
+      }
+
+      if (newCommit.notes.length > 0) {
+        discard = false
+      }
+
+      const typeMap = {
+        feat: '✨ Features | 新功能',
+        fix: '🐛 Bug Fixes | Bug 修复',
+        perf: '⚡ Performance Improvements | 性能优化',
+        revert: '⏪ Reverts | 回退',
+        refactor: '♻ Code Refactoring | 代码重构',
+        test: '✅ Tests | 测试',
+        build: '👷‍ Build System | 构建',
+        chore: '🎫 Chores | 其他更新',
+        style: '💄 Styles | 风格',
+        ci: '🔧 Continuous Integration | CI 配置',
+        docs: '📝 Documentation | 文档',
+      }
+
+      if (typeMap[newCommit.type]) {
+        newCommit.type = typeMap[newCommit.type]
+      } else if (newCommit.type === 'revert' || newCommit.revert) {
+        newCommit.type = typeMap['revert']
+      } else if (discard) {
+        return
+      }
+
+      if (newCommit.scope === '*') {
+        newCommit.scope = ''
+      }
+
+      if (typeof newCommit.hash === 'string') {
+        newCommit.shortHash = newCommit.hash.substring(0, 7)
+      }
+
+      if (typeof newCommit.subject === 'string') {
+        let url = context.repository ? `${context.host}/${context.owner}/${context.repository}` : context.repoUrl
+
+        if (url) {
+          url = `${url}/issues/`
+          newCommit.subject = newCommit.subject.replace(/#([0-9]+)/g, (_, issue) => {
+            issues.push(issue)
+            return `[#${issue}](${url}${issue})`
+          })
+        }
+
+        if (context.host) {
+          newCommit.subject = newCommit.subject.replace(/\B@([a-z0-9](?:-?[a-z0-9/]){0,38})/g, (_, username) => {
+            if (username.includes('/')) {
+              return `@${username}`
+            }
+            return `[@${username}](${context.host}/${username})`
+          })
+        }
+      }
+
+      newCommit.references = newCommit.references.filter(reference => {
+        if (issues.indexOf(reference.issue) === -1) {
+          return true
+        }
+        return false
+      })
+
+      return newCommit
+    },
+    groupBy: 'type',
+    commitGroupsSort: 'title',
+    commitsSort: ['scope', 'subject'],
+    noteGroupsSort: 'title',
+    notesSort: compareFunc,
+  },
+}

package/template/standard-js/commitlint.config.js

@@ -0,0 +1,25 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'perf',
+        'test',
+        'build',
+        'ci',
+        'chore',
+        'revert',
+        'build',
+        'release',
+      ],
+    ],
+    'subject-case': [0],
+  },
+}

package/template/standard-js/eslint.config.js

@@ -0,0 +1,42 @@
+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/'],
+  },
+  {
+    files: ['src/**/*.js', 'tests/**/*.js'],
+  },
+  {
+    languageOptions: {
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+      globals: {
+        ...globals.es2022,
+        ...globals.node,
+      },
+    },
+    plugins: {
+      import: importPlugin,
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      'no-console': 'off',
+      semi: ['warn', 'never'],
+      quotes: ['warn', 'single'],
+      'no-unused-vars': 'off',
+    },
+    settings: {
+      'import/resolver': {
+        node: {
+          extensions: ['.js'],
+        },
+      },
+    },
+  },
+]

package/template/standard-js/jsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./build",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src", "tests", "vitest.setup.js", "vitest.config.js"],
+  "exclude": ["node_modules"]
+}

package/template/standard-js/lint-staged.config.js

@@ -0,0 +1,3 @@
+export default {
+  'src/**/*.js': ['npx eslint'],
+}

package/template/standard-js/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.0",
+  "description": "{{PROJECT_NAME}}",
+  "author": "zhensherlock",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "{{PROJECT_NAME}}": "./build/index.js"
+  },
+  "files": [
+    "build",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "build/index.js",
+  "scripts": {
+    "prepare": "husky",
+    "lint": "npx eslint \"src/**/*.js\"",
+    "build": "cross-env NODE_ENV=production node scripts/build.js",
+    "dev": "npm run dev:stdio",
+    "dev:stdio": "cross-env NODE_ENV=local node scripts/dev.js",
+    "dev:web": "cross-env NODE_ENV=local TRANSPORT=web node scripts/dev.js",
+    "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"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.1",
+    "cors": "^2.8.5",
+    "dotenv": "^17.2.1",
+    "express": "^5.1.0",
+    "nanoid": "^5.1.5",
+    "node-fetch": "^3.3.2",
+    "yargs": "^17.7.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@modelcontextprotocol/inspector": "^0.16.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "c8": "^10.1.3",
+    "compare-func": "^2.0.0",
+    "concurrently": "^9.2.0",
+    "conventional-changelog-angular": "^8.0.0",
+    "conventional-changelog-cli": "^5.0.0",
+    "cross-env": "^10.0.0",
+    "esbuild": "^0.25.8",
+    "eslint": "^9.32.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.3",
+    "globals": "^16.3.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.4",
+    "nyc": "^17.1.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "tree-kill": "^1.2.2",
+    "vitest": "^3.2.4"
+  }
+}

package/template/standard-js/scripts/base.js

@@ -0,0 +1,82 @@
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { promises as fs } from 'fs'
+import { spawn } from 'child_process'
+import { rimraf } from 'rimraf'
+import kill from 'tree-kill'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const isProd = process.env.NODE_ENV === 'production'
+const isDev = process.env.NODE_ENV === 'local'
+let inspectorProcess = null
+let webProcess = null
+let autoOpenBrowser = true
+
+/** @type {import('esbuild').BuildOptions} */
+export const config = {
+  entryPoints: [path.resolve(__dirname, '../src/index.js')],
+  outfile: path.resolve(__dirname, '../build/index.js'),
+  format: 'esm',
+  bundle: true,
+  sourcemap: isDev,
+  minify: isProd,
+  platform: 'node',
+  external: ['yargs', 'node-fetch', 'cors', 'express', 'nanoid', 'zod', 'dotenv', '@modelcontextprotocol/sdk'],
+  alias: {
+    '@': path.resolve(__dirname, '../src'),
+  },
+  plugins: [
+    {
+      name: 'build-plugin',
+      setup(build) {
+        build.onStart(async result => {
+          await before(result)
+        })
+        build.onEnd(async result => {
+          await after(result)
+        })
+      },
+    },
+  ],
+}
+
+const before = async () => {
+  await rimraf('build')
+}
+
+const after = async result => {
+  await fs.chmod('build/index.js', 0o755)
+  console.log('✅ chmod 755 build/index.js done')
+  if (isDev) {
+    if (result.errors.length === 0) {
+      console.log('✅ Rebuild succeeded')
+    } else {
+      console.error('❌ Rebuild failed')
+    }
+
+    console.log('🚀 Starting @modelcontextprotocol/inspector...')
+    if (inspectorProcess) {
+      kill(inspectorProcess.pid, 'SIGINT')
+      // inspectorProcess.kill('SIGINT')
+    }
+    inspectorProcess = spawn('npx', ['@modelcontextprotocol/inspector', 'build/index.js'], {
+      stdio: 'inherit',
+      shell: true,
+      env: {
+        ...process.env,
+        DANGEROUSLY_OMIT_AUTH: true,
+        MCP_AUTO_OPEN_ENABLED: autoOpenBrowser,
+      },
+    })
+    autoOpenBrowser = false
+
+    if (process.env.TRANSPORT === 'web') {
+      if (webProcess) {
+        webProcess.kill('SIGINT')
+      }
+      webProcess = spawn('node', ['build/index.js', 'web'], {
+        stdio: 'inherit',
+      })
+    }
+  }
+}

package/template/standard-js/scripts/build.js

@@ -0,0 +1,4 @@
+import esbuild from 'esbuild'
+import { config } from './base.js'
+
+esbuild.build(config).catch(() => process.exit(1))

package/template/standard-js/scripts/dev.js

@@ -0,0 +1,7 @@
+import { context } from 'esbuild'
+import { config } from './base.js'
+
+const ctx = await context(config)
+await ctx.watch()
+
+console.log('🔍 Watching for changes...')

package/template/standard-js/src/constants/index.js

@@ -0,0 +1 @@
+export const MagicSeparator = '###MAGIC###'

package/template/standard-js/src/index.js

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

package/template/standard-js/src/prompts/index.js

@@ -0,0 +1,27 @@
+import { z } from 'zod'
+
+export const registerPrompts = server => {
+  server.registerPrompt(
+    'echo',
+    {
+      title: 'Echo Prompt',
+      description: 'Creates a prompt to process a message.',
+      argsSchema: {
+        message: z.string(),
+      },
+    },
+    ({ message }) => {
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: `Please process this message: ${message}`,
+            },
+          },
+        ],
+      }
+    },
+  )
+}

package/template/standard-js/src/resources/index.js

@@ -0,0 +1,24 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
+
+export const registerResources = (server, options) => {
+  server.registerResource(
+    'search',
+    new ResourceTemplate('search://{keyword}', {
+      list: undefined,
+    }),
+    {
+      title: 'Search Resource',
+      description: 'Dynamic generate search resource',
+    },
+    async (uri, { keyword }) => {
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            text: `search ${keyword}`,
+          },
+        ],
+      }
+    },
+  )
+}

package/template/standard-js/src/services/index.js

@@ -0,0 +1,27 @@
+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'
+import { stdioServer } from './stdio.js'
+import { webServer } from './web.js'
+
+const createServer = options => {
+  const server = new McpServer({
+    name: options.name,
+    version: options.version,
+  })
+  registerTools(server, options)
+  registerResources(server, options)
+  registerPrompts(server)
+  return server
+}
+
+export async function startStdioServer(options) {
+  const server = createServer(options)
+  await stdioServer(server)
+}
+
+export async function startWebServer(options) {
+  const server = createServer(options)
+  await webServer(server, options)
+}

package/template/standard-js/src/services/stdio.js

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

package/template/standard-js/src/services/web.js

@@ -0,0 +1,88 @@
+import { nanoid } from 'nanoid'
+import express from 'express'
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js'
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'
+
+export async function webServer(server, options) {
+  const app = express()
+  app.use(express.json())
+
+  const transports = {
+    streamable: {},
+    sse: {},
+  }
+  app.post('/mcp', async (req, res) => {
+    const sessionId = req.headers['mcp-session-id']
+    let transport
+
+    if (sessionId && transports.streamable[sessionId]) {
+      transport = transports.streamable[sessionId]
+    } else if (!sessionId && isInitializeRequest(req.body)) {
+      transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => nanoid(),
+        onsessioninitialized: sessionId => {
+          transports.streamable[sessionId] = transport
+        },
+      })
+
+      transport.onclose = () => {
+        if (transport.sessionId) {
+          delete transports.streamable[transport.sessionId]
+        }
+      }
+      await server.connect(transport)
+    } else {
+      res.status(400).json({
+        jsonrpc: '2.0',
+        error: {
+          code: -32000,
+          message: 'Bad Request: No valid session ID provided',
+        },
+        id: null,
+      })
+      return
+    }
+
+    await transport.handleRequest(req, res, req.body)
+  })
+
+  const handleSessionRequest = async (req, res) => {
+    const sessionId = req.headers['mcp-session-id']
+    if (!sessionId || !transports.streamable[sessionId]) {
+      res.status(400).send('Invalid or missing session ID')
+      return
+    }
+
+    const transport = transports.streamable[sessionId]
+    await transport.handleRequest(req, res)
+  }
+
+  app.get('/mcp', handleSessionRequest)
+
+  app.delete('/mcp', handleSessionRequest)
+
+  app.get('/sse', async (req, res) => {
+    const transport = new SSEServerTransport('/messages', res)
+    transports.sse[transport.sessionId] = transport
+
+    res.on('close', () => {
+      delete transports.sse[transport.sessionId]
+    })
+
+    await server.connect(transport)
+  })
+
+  app.post('/messages', async (req, res) => {
+    const sessionId = req.query.sessionId
+    const transport = transports.sse[sessionId]
+    if (transport) {
+      await transport.handlePostMessage(req, res, req.body)
+    } else {
+      res.status(400).send('No transport found for sessionId')
+    }
+  })
+
+  app.listen(options.port)
+  console.log(`MCP server started on port ${options.port}. SSE endpoint: /sse, streamable endpoint: /mcp`)
+}

package/template/standard-js/src/tools/index.js

@@ -0,0 +1,5 @@
+import registerGetData from './registerGetData.js'
+
+export const registerTools = (server, options) => {
+  registerGetData(server, options)
+}

package/template/standard-js/src/tools/registerGetData.js

@@ -0,0 +1,38 @@
+import { z } from 'zod'
+
+export default function register(server, options) {
+  server.registerTool(
+    'GetData',
+    {
+      title: 'Get Data',
+      description: 'Get Data',
+      inputSchema: {
+        keyword: z.string().describe('search keyword'),
+      },
+    },
+    async ({ keyword }) => {
+      const { success, data, message } = await getData(keyword, options)
+      return {
+        content: [
+          {
+            type: 'text',
+            text: success ? data : message,
+          },
+        ],
+      }
+    },
+  )
+}
+
+export const getData = async (keyword, options) => {
+  if (!keyword || keyword === 'error') {
+    return {
+      success: false,
+      message: 'not found',
+    }
+  }
+  return {
+    success: true,
+    data: `keyword: ${keyword};`,
+  }
+}

package/template/standard-js/src/utils/index.js

@@ -0,0 +1,7 @@
+export function getOptions(argv, pkg) {
+  return {
+    name: pkg.name,
+    version: pkg.version,
+    port: argv.port,
+  }
+}

package/template/standard-js/tests/prompts/index.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, test } from 'vitest'
+
+describe('echoPrompt', () => {
+  test('should return correct prompt content for a valid argument', async () => {
+    expect(
+      await global.client.getPrompt({
+        name: 'echo',
+        arguments: {
+          message: 'hello',
+        },
+      }),
+    ).toStrictEqual({
+      messages: [
+        {
+          role: 'user',
+          content: {
+            type: 'text',
+            text: 'Please process this message: hello',
+          },
+        },
+      ],
+    })
+  })
+})

package/template/standard-js/tests/resources/index.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, test } from 'vitest'
+
+describe('searchResource', () => {
+  test('should return correct resource content for a valid URI', async () => {
+    expect(
+      await global.client.readResource({
+        uri: 'search://hello',
+      }),
+    ).toStrictEqual({
+      contents: [
+        {
+          uri: 'search://hello',
+          text: 'search hello',
+        },
+      ],
+    })
+  })
+})

package/template/standard-js/tests/tools/index.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, test } from 'vitest'
+
+describe('getDataTool', () => {
+  test('returns data for a valid input', async () => {
+    expect(
+      await global.client.callTool({
+        name: 'GetData',
+        arguments: {
+          keyword: 'test',
+        },
+      }),
+    ).toStrictEqual({
+      content: [{ type: 'text', text: 'keyword: test;' }],
+    })
+  })
+
+  test('returns a "not found" response for an unrecognized input', async () => {
+    expect(
+      await global.client.callTool({
+        name: 'GetData',
+        arguments: {
+          keyword: 'error',
+        },
+      }),
+    ).toStrictEqual({
+      content: [{ type: 'text', text: 'not found' }],
+    })
+  })
+
+  test('returns a "not found" response for empty input', async () => {
+    expect(
+      await global.client.callTool({
+        name: 'GetData',
+        arguments: {
+          keyword: '',
+        },
+      }),
+    ).toStrictEqual({
+      content: [{ type: 'text', text: 'not found' }],
+    })
+  })
+})

package/template/standard-js/vitest.config.js

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    setupFiles: ['./vitest.setup.js'],
+    coverage: {
+      include: ['src/**/*.js'],
+    },
+  },
+})

package/template/standard-js/vitest.setup.js

@@ -0,0 +1,19 @@
+import 'dotenv/config'
+import { Client } from '@modelcontextprotocol/sdk/client/index.js'
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'
+
+const serverParams = new StdioClientTransport({
+  command: 'nyc',
+  args: ['--merge-async', '--reporter=lcov', '--reporter=text', 'node', './src/index.js'],
+  env: {
+    ...process.env,
+    NODE_V8_COVERAGE: './coverage/tmp',
+  },
+})
+const client = new Client({
+  name: 'test-mcp-client',
+  version: '1.0.0',
+})
+await client.connect(serverParams)
+
+global.client = client

package/template/standard-ts/_github/workflows/build.yml

@@ -24,6 +24,9 @@ jobs:
       - name: Install Package
         run: npm i
 
+      - name: Lint
+        run: npm run lint
+
       - name: Build Package
         run: npm run build
 

package/template/standard-ts/_github/workflows/npm-publish.yml

@@ -27,6 +27,9 @@ jobs:
       - name: Install Package
         run: npm i
 
+      - name: Lint
+        run: npm run lint
+
       - name: Build Package
         run: npm run build
 

package/template/standard-ts/package.json

@@ -58,7 +58,7 @@
     "eslint-plugin-prettier": "^5.5.3",
     "globals": "^16.3.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.1.2",
+    "lint-staged": "^16.1.4",
     "nyc": "^17.1.0",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",

package/template/standard-ts/src/prompts/index.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod'
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 
 export const registerPrompts = (server: McpServer) => {
   server.registerPrompt(

package/template/standard-ts/src/resources/index.ts

@@ -1,4 +1,4 @@
-import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { type McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
 import type { OptionsType } from '@/types'
 
 export const registerResources = (server: McpServer, options: OptionsType) => {

package/template/standard-ts/src/services/web.ts

@@ -1,9 +1,9 @@
 import { nanoid } from 'nanoid'
 import express from 'express'
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js'
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import type { OptionsType } from '@/types'
 
 export async function webServer(server: McpServer, options: OptionsType) {

package/template/standard-ts/vitest.setup.ts

@@ -9,7 +9,7 @@ const serverParams = new StdioClientTransport({
     '--reporter=lcov',
     '--reporter=text',
     'tsx',
-    './src/index.ts'
+    './src/index.ts',
   ],
   env: {
     ...process.env as Record<string, string>,