create-mcp-kit 0.0.1 → 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

@@ -1,3 +1,90 @@
 #!/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
+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";
+
+//#region src/index.ts
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+clack.intro(pc.inverse(" create-mcp-kit "));
+const group = await clack.group({
+	type: () => clack.select({
+		message: "Project type:",
+		options: [{
+			value: "server",
+			label: pc.magenta("MCP Server")
+		}]
+	}),
+	name: ({ results }) => clack.text({
+		message: "Project name:",
+		defaultValue: `mcp-${results.type}-starter`,
+		placeholder: `mcp-${results.type}-starter`
+	}),
+	language: () => clack.select({
+		message: "Project language:",
+		options: [{
+			value: "ts",
+			label: pc.magenta("TypeScript")
+		}, {
+			value: "js",
+			label: pc.blue("JavaScript")
+		}]
+	}),
+	template: () => clack.select({
+		message: "Project template:",
+		options: [{
+			value: "standard",
+			label: pc.magenta("Standard")
+		}]
+	}),
+	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 targetPath = resolve(process.cwd(), group.name);
+try {
+	await stat(templatePath);
+} catch {
+	clack.log.error(`Template not found: ${templatePath}`);
+	process.exit(1);
+}
+try {
+	await stat(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 });
+	} catch (error) {
+		createSpinner.stop("Failed to create project");
+		clack.log.error(error.message);
+		process.exit(1);
+	}
+	createSpinner.stop(pc.green("Project created!"));
+}
+if (group.install) {
+	const spinner = clack.spinner();
+	spinner.start("Installing dependencies...");
+	await installDependencies(targetPath);
+	spinner.stop(pc.green("Dependencies installed!"));
+}
+clack.outro(`
+${pc.green("✓")} Project created successfully!
+
+${pc.cyan("Next steps:")}
+  ${pc.dim("cd")} ${group.name}
+  ${group.install ? "" : `${pc.dim("npm install")}\n  `}${pc.dim("npm run dev")}
+
+Enjoy coding! 🎉
+  `);
+
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mcp-kit",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "create mcp tool kit",
   "type": "module",
   "author": "zhensherlock",
@@ -41,10 +41,10 @@
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "picocolors": "^1.1.1",
-    "@mcp-tool-kit/shared": "^0.0.2"
+    "@mcp-tool-kit/shared": "^0.0.4"
   },
   "devDependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@modelcontextprotocol/sdk": "^1.17.1",
     "@types/express": "^5.0.3",
     "@types/yargs": "^17.0.33",
     "express": "^5.1.0",
@@ -55,8 +55,8 @@
   "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",
+    "build": "cross-env NODE_ENV=production && npm run clean:dist && npm run build:types && rolldown -c rolldown.config.ts",
+    "dev": "cross-env NODE_ENV=local && rolldown -c rolldown.config.ts --watch",
     "start": "node ./dist/index.js"
   }
 }

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"
+  }
+}