create-mcp-kit 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Watermark Design
+
+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/README.md

@@ -0,0 +1,125 @@
+# create-mcp-kit
+A CLI tool to create MCP (Model Context Protocol) applications with ease.
+
+## Features
+- 🚀 Quick project scaffolding
+- 📦 TypeScript support out of the box
+- 🛠️ Built-in development tools
+- 🔧 Configurable project templates
+
+## Usage
+
+```bash
+npm create mcp-kit@latest
+```
+
+or
+
+```bash
+yarn create mcp-kit@latest
+```
+
+or
+
+```bash
+pnpm create mcp-kit@latest
+```
+
+## Project Structure
+
+```text
+The generated project will have the following structure:
+
+├── src/
+│   ├── tools/          # MCP tools implementation
+│   ├── resources/      # MCP resources implementation
+│   ├── prompts/        # MCP prompts implementation
+│   ├── services/       # Server implementations (stdio/web)
+│   └── index.ts        # Entry point
+├── tests/              # Test files
+├── scripts/            # Build and development scripts
+├── .github/            # GitHub Actions workflows
+└── package.json
+```
+
+## Development Scripts
+
+- npm run dev - Start the development server in stdio mode
+- npm run dev:web - Start the development server in web mode
+- npm run build - Build the project
+- npm run test - Run tests
+- npm run coverage - Generate test coverage report
+
+## Features
+### MCP Tools
+Implement custom tools that can be used by MCP clients:
+
+```ts
+server.registerTool(
+  'GetData',
+  {
+    title: 'Get Data',
+    description: 'Get Data',
+    inputSchema: {
+      keyword: z.string().describe('search keyword'),
+    },
+  },
+  async ({ keyword }) => {
+    // Your implementation
+  }
+)
+```
+### MCP Resources
+Define resources that can be accessed by MCP clients:
+
+```ts
+server.registerResource(
+  'search',
+  new ResourceTemplate('search://{keyword}', {
+    list: undefined,
+  }),
+  {
+    title: 'Search Resource',
+    description: 'Dynamic generate search resource',
+  },
+  async (uri, { keyword }) => {
+    // Your implementation
+  }
+)
+```
+### MCP Prompts
+Create reusable prompts for MCP clients:
+
+```ts
+server.registerPrompt(
+  'echo',
+  {
+    title: 'Echo Prompt',
+    description: 'Creates a prompt to process a message.',
+    argsSchema: {
+      message: z.string(),
+    },
+  },
+  ({ message }) => {
+    // Your implementation
+  }
+)
+```
+
+## Contributing
+
+Feel free to dive in! [Open an issue](https://github.com/my-mcp-hub/mcp-kit/issues/new/choose) or submit PRs.
+
+Standard Readme follows the [Contributor Covenant](http://contributor-covenant.org/version/1/3/0/) Code of Conduct.
+
+### Contributors
+
+This project exists thanks to all the people who contribute.
+
+<a href="https://github.com/my-mcp-hub/mcp-kit/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=my-mcp-hub/mcp-kit" />
+</a>
+
+## License
+
+[MIT](LICENSE) © MichaelSun

package/dist/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import*as e from"@clack/prompts";import t from"picocolors";import{fileURLToPath as r}from"url";import a,{dirname as n,join as o,resolve as s}from"path";import{cp as i,mkdir as c,readFile as p,readdir as l,rename as m,stat as g,writeFile as u}from"fs/promises";import{setTimeout as d}from"timers/promises";import{spawn as f}from"child_process";const w=n(r(import.meta.url));e.intro(t.inverse(" create-mcp-kit "));const y=await e.group({type:()=>e.select({message:"Project type:",options:[{value:"server",label:t.magenta("MCP Server")}]}),name:({results:t})=>e.text({message:"Project name:",defaultValue:`mcp-${t.type}-starter`,placeholder:`mcp-${t.type}-starter`}),language:()=>e.select({message:"Project language:",options:[{value:"ts",label:t.magenta("TypeScript")}]}),template:()=>e.select({message:"Project template:",options:[{value:"standard",label:t.magenta("Standard")}]}),install:()=>e.confirm({message:"Do you want to install dependencies?"})},{onCancel:()=>{e.cancel("Operation cancelled."),process.exit(0)}}),v=o(w,"../template",`${y.template}-${y.language}`),j=s(process.cwd(),y.name);try{await g(v)}catch{e.log.error(`Template not found: ${v}`),process.exit(1)}try{await g(j),e.log.error(`Directory ${y.name} already exists`),process.exit(1)}catch{}{const r=e.spinner();r.start("Creating project..."),await d(100);try{await async function(e,t,r){await c(e,{recursive:!0}),await i(t,e,{recursive:!0}),await async function(e){const t={_env:".env",_gitignore:".gitignore",_git:".git",_nvmrc:".nvmrc",_prettierrc:".prettierrc",_husky:".husky",_github:".github"},r=await l(e,{recursive:!0});for(const n of r)n in t&&await m(a.join(e,n),a.join(e,t[n]))}(e),await async function(e,t){const r={"{{PROJECT_NAME}}":t.projectName,"{{YEAR}}":(new Date).getFullYear().toString()},n=await l(e,{recursive:!0});for(const t of n){const n=a.join(e,t);if(!(await g(n)).isDirectory())for(const[e,t]of Object.entries(r)){const r=await p(n,"utf-8"),a=new RegExp(e,"g"),o=r.replace(a,t);await u(n,o,"utf-8")}}}(e,r)}(j,v,{projectName:y.name})}catch(t){r.stop("Failed to create project"),e.log.error(t.message),process.exit(1)}r.stop(t.green("Project created!"))}if(y.install){const r=e.spinner();r.start("Installing dependencies..."),await($=j,new Promise((e,t)=>{const r=f("npm",["install"],{cwd:$,stdio:"pipe"});r.on("close",r=>{0===r?e():t(new Error(`npm install failed with code ${r}`))}),r.on("error",t)})),r.stop(t.green("Dependencies installed!"))}var $;e.outro(`\n${t.green("✓")} Project created successfully!\n\n${t.cyan("Next steps:")}\n  ${t.dim("cd")} ${y.name}\n  ${t.dim("npm install")}\n  ${t.dim("npm run dev")}\n\nEnjoy coding! 🎉\n  `);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["t","m","i","r","n"],"sources":["../../shared/dist/projectSetup.js","../src/index.ts"],"sourcesContent":["import{setTimeout as t}from\"timers/promises\";import{cp as i,mkdir as r,readFile as o,readdir as e,rename as n,stat as s,writeFile as a}from\"fs/promises\";import c from\"path\";import{spawn as f}from\"child_process\";function m(t){return new Promise((i,r)=>{const o=f(\"npm\",[\"install\"],{cwd:t,stdio:\"pipe\"});o.on(\"close\",t=>{0===t?i():r(new Error(`npm install failed with code ${t}`))}),o.on(\"error\",r)})}async function p(t,f,m){await r(t,{recursive:!0}),await i(f,t,{recursive:!0}),await async function(t){const i={_env:\".env\",_gitignore:\".gitignore\",_git:\".git\",_nvmrc:\".nvmrc\",_prettierrc:\".prettierrc\",_husky:\".husky\",_github:\".github\"},r=await e(t,{recursive:!0});for(const o of r)o in i&&await n(c.join(t,o),c.join(t,i[o]))}(t),await async function(t,i){const r={\"{{PROJECT_NAME}}\":i.projectName,\"{{YEAR}}\":(new Date).getFullYear().toString()},n=await e(t,{recursive:!0});for(const i of n){const e=c.join(t,i);if(!(await s(e)).isDirectory())for(const[t,i]of Object.entries(r)){const r=await o(e,\"utf-8\"),n=new RegExp(t,\"g\"),s=r.replace(n,i);await a(e,s,\"utf-8\")}}}(t,m)}export{p as createProject,m as installDependencies,t as sleep};\n//# sourceMappingURL=projectSetup.js.map","#!/usr/bin/env node\nimport * as clack from '@clack/prompts'\nimport pc from 'picocolors'\nimport { fileURLToPath } from 'url'\nimport { dirname, join, resolve } from 'path'\nimport { stat } from 'fs/promises'\nimport { sleep, createProject, installDependencies } from '@mcp-tool-kit/shared'\n\nconst __filename = fileURLToPath(import.meta.url)\nconst __dirname = dirname(__filename)\nclack.intro(pc.inverse(' create-mcp-kit '))\n\nconst group = await clack.group(\n  {\n    type: () =>\n      clack.select({\n        message: 'Project type:',\n        options: [\n          { value: 'server', label: pc.magenta('MCP Server') },\n          // { value: 'client', label: pc.blue('MCP Client') },\n          // { value: 'host', label: pc.green('MCP Host') },\n        ],\n      }),\n    name: ({ results }) =>\n      clack.text({\n        message: 'Project name:',\n        defaultValue: `mcp-${results.type}-starter`,\n        placeholder: `mcp-${results.type}-starter`,\n      }),\n    language: () =>\n      clack.select({\n        message: 'Project language:',\n        options: [\n          { value: 'ts', label: pc.magenta('TypeScript') },\n          // { value: 'js', label: pc.blue('JavaScript') },\n        ],\n      }),\n    template: () =>\n      clack.select({\n        message: 'Project template:',\n        options: [\n          { value: 'standard', label: pc.magenta('Standard') },\n          // { value: 'custom', label: pc.blue('Custom') },\n        ],\n      }),\n    install: () =>\n      clack.confirm({\n        message: 'Do you want to install dependencies?',\n      }),\n  },\n  {\n    onCancel: () => {\n      clack.cancel('Operation cancelled.')\n      process.exit(0)\n    },\n  },\n)\n\nconst templatePath = join(__dirname, '../template', `${group.template}-${group.language}`)\nconst targetPath = resolve(process.cwd(), group.name as string)\n\ntry {\n  await stat(templatePath)\n} catch {\n  clack.log.error(`Template not found: ${templatePath}`)\n  process.exit(1)\n}\n\ntry {\n  await stat(targetPath)\n  clack.log.error(`Directory ${group.name} already exists`)\n  process.exit(1)\n} catch {}\n\n{\n  const createSpinner = clack.spinner()\n  createSpinner.start('Creating project...')\n  await sleep(100)\n  try {\n    await createProject(targetPath, templatePath, {\n      projectName: group.name as string,\n    })\n  } catch (error) {\n    createSpinner.stop('Failed to create project')\n    clack.log.error((error as Error).message)\n    process.exit(1)\n  }\n  createSpinner.stop(pc.green('Project created!'))\n}\n\nif (group.install) {\n  const spinner = clack.spinner()\n  spinner.start('Installing dependencies...')\n  await installDependencies(targetPath)\n  spinner.stop(pc.green('Dependencies installed!'))\n}\n\nclack.outro(`\n${pc.green('✓')} Project created successfully!\n\n${pc.cyan('Next steps:')}\n  ${pc.dim('cd')} ${group.name}\n  ${pc.dim('npm install')}\n  ${pc.dim('npm run dev')}\n\nEnjoy coding! 🎉\n  `)\n"],"mappings":";uVCQA,MACM,EAAY,EADC,cAA0B,MAE7C,EAAM,MAAM,EAAG,QAAQ,qBAEvB,MAAM,QAAc,EAAM,MACxB,CACE,KAAM,IACJ,EAAM,OAAO,CACX,QAAS,gBACT,QAAS,CACP,CAAE,MAAO,SAAU,MAAO,EAAG,QAAQ,kBAK3C,KAAM,EAAG,aACP,EAAM,KAAK,CACT,QAAS,gBACT,aAAc,OAAO,EAAQ,eAC7B,YAAa,OAAO,EAAQ,iBAEhC,SAAU,IACR,EAAM,OAAO,CACX,QAAS,oBACT,QAAS,CACP,CAAE,MAAO,KAAM,MAAO,EAAG,QAAQ,kBAIvC,SAAU,IACR,EAAM,OAAO,CACX,QAAS,oBACT,QAAS,CACP,CAAE,MAAO,WAAY,MAAO,EAAG,QAAQ,gBAI7C,QAAS,IACP,EAAM,QAAQ,CACZ,QAAS,0CAGf,CACE,SAAU,KACR,EAAM,OAAO,wBACb,QAAQ,KAAK,MAKb,EAAe,EAAK,EAAW,cAAe,GAAG,EAAM,YAAY,EAAM,YACzE,EAAa,EAAQ,QAAQ,MAAO,EAAM,MAEhD,UACQ,EAAK,EACZ,CAAA,MACC,EAAM,IAAI,MAAM,uBAAuB,KACvC,QAAQ,KAAK,EACd,CAED,UACQ,EAAK,GACX,EAAM,IAAI,MAAM,aAAa,EAAM,uBACnC,QAAQ,KAAK,EACd,CAAA,MAAS,CAEV,CACE,MAAM,EAAgB,EAAM,UAC5B,EAAc,MAAM,6BACd,EAAM,KACZ,yBD9E8ZA,EAAE,EAAEC,SAAS,EAAED,EAAE,CAAC,WAAA,UAAqB,EAAE,EAAEA,EAAE,CAAC,WAAA,UAAqB,eAAeA,GAAG,MAAM,EAAE,CAAC,KAAK,OAAO,WAAW,aAAa,KAAK,OAAO,OAAO,SAAS,YAAY,cAAc,OAAO,SAAS,QAAQ,WAAW,QAAQ,EAAEA,EAAE,CAAC,WAAA,IAAe,IAAI,MAAM,KAAK,EAAE,KAAK,SAAS,EAAE,EAAE,KAAKA,EAAE,GAAG,EAAE,KAAKA,EAAE,EAAE,IAAK,CAAjP,CAAkPA,SAAS,eAAeA,EAAE,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,YAAY,YAAW,IAAK,MAAM,cAAc,YAAY,QAAQ,EAAEA,EAAE,CAAC,WAAA,IAAe,IAAI,MAAME,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,KAAKF,EAAEE,GAAG,WAAW,EAAE,IAAI,cAAc,IAAI,MAAMF,EAAEE,KAAK,OAAO,QAAQ,GAAG,CAAC,MAAMC,QAAQ,EAAE,EAAE,SAASC,EAAE,IAAI,OAAOJ,EAAE,KAAK,EAAE,EAAE,QAAQI,EAAEF,SAAS,EAAE,EAAE,EAAE,QAAS,CAAC,CAAC,CAA1U,CAA2UF,EAAEC,EAAG,CC+EpiC,CAAc,EAAY,EAAc,CAC5C,YAAa,EAAM,MAEtB,CAAA,MAAQ,GACP,EAAc,KAAK,4BACnB,EAAM,IAAI,MAAO,EAAgB,SACjC,QAAQ,KAAK,EACd,CACD,EAAc,KAAK,EAAG,MAAM,oBAC7B,CAED,GAAI,EAAM,QAAS,CACjB,MAAM,EAAU,EAAM,UACtB,EAAQ,MAAM,oCD5F8MD,EC6FlM,ED7F4M,IAAI,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,IAAIA,EAAE,MAAM,SAAS,EAAE,GAAG,QAAQ,IAAI,IAAIA,EAAE,IAAI,EAAE,IAAI,MAAM,gCAAgCA,QAAQ,EAAE,GAAG,QAAQ,MC8FxY,EAAQ,KAAK,EAAG,MAAM,2BACvB,CD/FkN,IAAWA,ECiG9N,EAAM,MAAM,KACV,EAAG,MAAM,yCAET,EAAG,KAAK,qBACN,EAAG,IAAI,SAAS,EAAM,WACtB,EAAG,IAAI,qBACP,EAAG,IAAI"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "create-mcp-kit",
+  "version": "0.0.1",
+  "description": "create mcp tool kit",
+  "type": "module",
+  "author": "zhensherlock",
+  "homepage": "https://github.com/my-mcp-hub/mcp-kit/tree/master/packages/create#readme",
+  "bin": {
+    "create-mcp-kit": "./dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp server",
+    "mcp client",
+    "mcp kit",
+    "mcp tool kit",
+    "create mcp",
+    "create mcp server",
+    "create mcp client",
+    "modelcontextprotocol",
+    "typescript"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "template",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/my-mcp-hub/mcp-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/my-mcp-hub/mcp-kit/issues"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "picocolors": "^1.1.1",
+    "@mcp-tool-kit/shared": "^0.0.2"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@types/express": "^5.0.3",
+    "@types/yargs": "^17.0.33",
+    "express": "^5.1.0",
+    "nanoid": "^5.1.5",
+    "yargs": "^17.7.2",
+    "zod": "^3.25.76"
+  },
+  "scripts": {
+    "clean:dist": "rimraf dist",
+    "build:types": "tsc --noEmit",
+    "build": "npm run clean:dist && npm run build:types && rolldown -c rolldown.config.ts",
+    "dev": "rolldown -c rolldown.config.ts --watch",
+    "start": "node ./dist/index.js"
+  }
+}

package/template/standard-ts/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-ts/_env

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

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

@@ -0,0 +1,34 @@
+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: Build Package
+        run: npm run build
+
+      - name: Test Package
+        run: npm run coverage
+
+      - name: Coveralls
+        uses: coverallsapp/github-action@v2

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

@@ -0,0 +1,36 @@
+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: 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-ts/_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-ts/_husky/commit-msg

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

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

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

package/template/standard-ts/_nvmrc

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

package/template/standard-ts/_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-ts/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-ts/commitlint.config.js

@@ -0,0 +1,27 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    // type 类型定义，表示 git 提交的 type 必须在以下类型范围内
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat', // 新功能
+        'fix', //  修复
+        'docs', // 文档变更
+        'style', // 代码格式
+        'refactor', // 重构
+        'perf', // 性能优化
+        'test', // 增加测试
+        'build', // 构建
+        'ci', // CI配置
+        'chore', // 构建过程或辅助工具的变动
+        'revert', // 回退
+        'build', // 打包
+        'release', // 发版
+      ],
+    ],
+    // subject 大小写不做校验
+    'subject-case': [0],
+  },
+}

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

@@ -0,0 +1,49 @@
+import tsParser from '@typescript-eslint/parser'
+import tsPlugin from '@typescript-eslint/eslint-plugin'
+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,ts}', 'tests/**/*.{js,ts}'],
+  },
+  {
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+      globals: {
+        ...globals.es2022,
+        ...globals.node,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+      import: importPlugin,
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      'no-console': 'off',
+      semi: ['warn', 'never'],
+      quotes: ['warn', 'single'],
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': 'warn',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-expressions': ['error', { allowShortCircuit: true, allowTernary: true }],
+    },
+    settings: {
+      'import/resolver': {
+        node: {
+          extensions: ['.js', '.ts'],
+        },
+      },
+    },
+  },
+]

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

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

package/template/standard-ts/package.json

@@ -0,0 +1,70 @@
+{
+  "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/**/*.{ts,js}\"",
+    "build": "tsc --noEmit && cross-env NODE_ENV=production node scripts/build.js",
+    "dev": "npm run dev:stdio",
+    "dev:stdio": "cross-env NODE_ENV=local concurrently \"tsc --noEmit --watch\" \"node scripts/dev.js\"",
+    "dev:web": "cross-env NODE_ENV=local TRANSPORT=web concurrently \"tsc --noEmit --watch\" \"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.0",
+    "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",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.3",
+    "@types/node-fetch": "^2.6.12",
+    "@types/yargs": "^17.0.33",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "@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": "^7.0.3",
+    "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.2",
+    "nyc": "^17.1.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "tree-kill": "^1.2.2",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}

package/template/standard-ts/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.ts')],
+  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-ts/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-ts/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-ts/src/constants/index.ts

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

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

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import yargs, { type ArgumentsCamelCase } from 'yargs'
+import { hideBin } from 'yargs/helpers'
+import { startWebServer, startStdioServer } from './services'
+import { getOptions } from './utils'
+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: string, argv: ArgumentsCamelCase) {
+  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-ts/src/prompts/index.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod'
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+
+export const registerPrompts = (server: McpServer) => {
+  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-ts/src/resources/index.ts

@@ -0,0 +1,25 @@
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
+import type { OptionsType } from '@/types'
+
+export const registerResources = (server: McpServer, options: OptionsType) => {
+  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-ts/src/services/index.ts

@@ -0,0 +1,28 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { registerTools } from '@/tools'
+import { registerResources } from '@/resources'
+import { registerPrompts } from '@/prompts'
+import { stdioServer } from './stdio'
+import { webServer } from './web'
+import type { OptionsType } from '@/types'
+
+const createServer = (options: OptionsType) => {
+  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: OptionsType) {
+  const server = createServer(options)
+  await stdioServer(server)
+}
+
+export async function startWebServer(options: OptionsType) {
+  const server = createServer(options)
+  await webServer(server, options)
+}

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

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

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

@@ -0,0 +1,90 @@
+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 { OptionsType } from '@/types'
+
+export async function webServer(server: McpServer, options: OptionsType) {
+  const app = express()
+  app.use(express.json())
+
+  const transports = {
+    streamable: {} as Record<string, StreamableHTTPServerTransport>,
+    sse: {} as Record<string, SSEServerTransport>,
+  }
+  app.post('/mcp', async (req, res) => {
+    const sessionId = req.headers['mcp-session-id'] as string | undefined
+    let transport: StreamableHTTPServerTransport
+
+    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: express.Request, res: express.Response) => {
+    const sessionId = req.headers['mcp-session-id'] as string | undefined
+    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 as string
+    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-ts/src/tools/index.ts

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

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

@@ -0,0 +1,40 @@
+import { z } from 'zod'
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import type { OptionsType } from '@/types'
+
+export default function register(server: McpServer, options: OptionsType) {
+  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: string, options: OptionsType) => {
+  if (!keyword || keyword === 'error') {
+    return {
+      success: false,
+      message: 'not found',
+    }
+  }
+  return {
+    success: true,
+    data: `keyword: ${keyword};`,
+  }
+}

package/template/standard-ts/src/types/global.ts

@@ -0,0 +1,5 @@
+export interface OptionsType {
+  name: string
+  version: string
+  port: number
+}

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

@@ -0,0 +1 @@
+export * from './global'

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

@@ -0,0 +1,16 @@
+import type { ArgumentsCamelCase } from 'yargs'
+import type { OptionsType } from '@/types'
+
+export function getOptions(
+  argv: ArgumentsCamelCase,
+  pkg: {
+    name: string
+    version: string
+  },
+) {
+  return {
+    name: pkg.name,
+    version: pkg.version,
+    port: argv.port,
+  } as OptionsType
+}

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

@@ -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-ts/tests/resources/index.test.ts

@@ -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-ts/tests/tools/index.test.ts

@@ -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-ts/tests/vitest-global.d.ts

@@ -0,0 +1,5 @@
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js'
+
+declare global {
+  var client: Client;
+}

package/template/standard-ts/tsconfig.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.ts", "vitest.config.ts"],
+  "exclude": ["node_modules"]
+}

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

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

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

@@ -0,0 +1,25 @@
+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',
+    'tsx',
+    './src/index.ts'
+  ],
+  env: {
+    ...process.env as Record<string, string>,
+    NODE_V8_COVERAGE: './coverage/tmp',
+  },
+})
+const client = new Client({
+  name: 'test-mcp-client',
+  version: '1.0.0',
+})
+await client.connect(serverParams)
+
+global.client = client