create-mcp-kit 0.0.6 → 0.0.7

package/dist/index.js

@@ -32,7 +32,10 @@ const group = await clack.group({
 		message: "Project type:",
 		options: [{
 			value: "server",
-			label: pc.magenta("MCP Server")
+			label: pc.magentaBright("MCP Server")
+		}, {
+			value: "client",
+			label: pc.greenBright("MCP Client")
 		}]
 	}),
 	name: ({ results }) => clack.text({
@@ -44,10 +47,10 @@ const group = await clack.group({
 		message: "Project language:",
 		options: [{
 			value: "ts",
-			label: pc.magenta("TypeScript")
+			label: pc.magentaBright("TypeScript")
 		}, {
 			value: "js",
-			label: pc.blue("JavaScript")
+			label: pc.greenBright("JavaScript")
 		}]
 	}),
 	transports: () => {
@@ -58,15 +61,15 @@ const group = await clack.group({
 			options: [
 				{
 					value: "stdio",
-					label: pc.magenta("STDIO")
+					label: pc.magentaBright("STDIO")
 				},
 				{
 					value: "streamable",
-					label: pc.blue("Streamable HTTP")
+					label: pc.greenBright("Streamable HTTP")
 				},
 				{
 					value: "sse",
-					label: pc.yellow("SSE")
+					label: pc.yellowBright("SSE")
 				}
 			]
 		});
@@ -75,17 +78,17 @@ const group = await clack.group({
 		message: "Project template:",
 		options: [{
 			value: "standard",
-			label: pc.magenta("Standard (recommended)")
+			label: pc.magentaBright("Standard (recommended)")
 		}, {
 			value: "custom",
-			label: pc.blue("Custom")
+			label: pc.greenBright("Custom")
 		}]
 	}),
 	plugins: ({ results }) => {
 		if (results.template !== "custom") return Promise.resolve([
 			"github-action",
 			"vitest",
-			"inspector",
+			...results.type === "server" ? ["inspector"] : [],
 			"style",
 			"commitlint",
 			"changelog"
@@ -96,23 +99,23 @@ const group = await clack.group({
 			options: [
 				{
 					value: "github-action",
-					label: pc.magenta("GitHub Action")
+					label: pc.magentaBright("GitHub Action")
 				},
 				{
 					value: "vitest",
-					label: pc.green("Vitest")
+					label: pc.greenBright("Vitest")
 				},
-				{
+				...results.type === "server" ? [{
 					value: "inspector",
-					label: pc.blue("Inspector")
-				},
+					label: pc.cyanBright("Inspector")
+				}] : [],
 				{
 					value: "style",
-					label: pc.white("ESLint + Prettier + Lint-staged")
+					label: pc.yellowBright("ESLint + Prettier + Lint-staged")
 				},
 				{
 					value: "commitlint",
-					label: pc.gray("Commitlint")
+					label: pc.redBright("Commitlint")
 				},
 				{
 					value: "changelog",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-mcp-kit",
-  "version": "0.0.6",
-  "description": "create mcp tool kit",
+  "version": "0.0.7",
+  "description": "A CLI tool to create MCP (Model Context Protocol) applications with ease.",
   "type": "module",
   "author": "zhensherlock",
   "homepage": "https://github.com/my-mcp-hub/mcp-kit/tree/master/packages/create#readme",
@@ -12,11 +12,16 @@
     "mcp",
     "mcp server",
     "mcp client",
+    "mcp host",
     "mcp kit",
     "mcp tool kit",
+    "mcp cli",
+    "cli",
+    "cli tool",
     "create mcp",
     "create mcp server",
     "create mcp client",
+    "create mcp host",
     "modelcontextprotocol",
     "typescript"
   ],
@@ -43,7 +48,7 @@
     "gradient-string": "^3.0.0",
     "handlebars": "^4.7.8",
     "picocolors": "^1.1.1",
-    "@mcp-tool-kit/shared": "^0.0.7"
+    "@mcp-tool-kit/shared": "^0.0.8"
   },
   "devDependencies": {},
   "scripts": {

package/template/client-js/.gitignore.hbs

@@ -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/client-js/.nvmrc.hbs

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

package/template/client-js/.prettierrc.hbs

@@ -0,0 +1,13 @@
+{{#if (includes plugins 'style')}}
+{
+  "tabWidth": 2,
+  "printWidth": 120,
+  "useTabs": false,
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "jsxBracketSameLine": false,
+  "arrowParens": "avoid"
+}
+{{/if}}

package/template/client-js/LICENSE.hbs

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{year}} {{projectName}}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+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/client-js/_github/workflows/build.yml.hbs

@@ -0,0 +1,39 @@
+{{#if (includes plugins 'github-action')}}
+name: build
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    if: github.repository == '{{projectName}}'
+    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
+{{/if}}

package/template/client-js/_github/workflows/npm-publish.yml.hbs

@@ -0,0 +1,41 @@
+{{#if (includes plugins 'github-action')}}
+name: npm-publish
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    if: github.repository == '{{projectName}}'
+    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}}
+{{/if}}

package/template/client-js/_husky/commit-msg.hbs

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

package/template/client-js/_husky/pre-commit.hbs

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

package/template/client-js/changelog-option.js.hbs

@@ -0,0 +1,89 @@
+{{#if (includes plugins 'changelog')}}
+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,
+  },
+}
+{{/if}}

package/template/client-js/commitlint.config.js.hbs

@@ -0,0 +1,27 @@
+{{#if (includes plugins 'commitlint')}}
+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],
+  },
+}
+{{/if}}

package/template/client-js/eslint.config.js.hbs

@@ -0,0 +1,48 @@
+{{#if (includes plugins 'style')}}
+import importPlugin from 'eslint-plugin-import'
+import prettierPlugin from 'eslint-plugin-prettier'
+import globals from 'globals'
+
+export default [
+  {
+    ignores: ['**/build', '**/node_modules', '**/.*', '.husky/'],
+  },
+  {
+  {{#if (includes plugins 'vitest')}}
+    files: ['src/**/*.js', 'tests/**/*.js'],
+  {{else}}
+    files: ['src/**/*.js'],
+  {{/if}}
+  },
+  {
+    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'],
+        },
+      },
+    },
+  },
+]
+{{/if}}

package/template/client-js/jsconfig.json.hbs

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./build",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+{{#if (includes plugins 'vitest')}}
+  "include": ["src", "tests", "vitest.config.js", "vitest.global.js"],
+{{else}}
+  "include": ["src"],
+{{/if}}
+  "exclude": ["node_modules"]
+}

package/template/client-js/lint-staged.config.js.hbs

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

package/template/client-js/package.json.hbs

@@ -0,0 +1,66 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.0",
+  "description": "{{projectName}}",
+  "author": "zhensherlock",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "build",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "build/index.js",
+  "scripts": {
+{{#if (includes plugins 'style')}}
+    "lint": "npx eslint \"src/**/*.js\"",
+{{/if}}
+    "build": "tsc --noEmit && cross-env NODE_ENV=production node scripts/build.js",
+    "dev": "cross-env NODE_ENV=local node scripts/dev.js",
+{{#if (includes plugins 'vitest')}}
+    "test": "vitest run",
+    "coverage": "rimraf coverage && vitest run --coverage",
+{{/if}}
+{{#if (includes plugins 'changelog')}}
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0 -n changelog-option.js",
+{{/if}}
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.3",
+    "dotenv": "^17.2.1"
+  },
+  "devDependencies": {
+{{#if (includes plugins 'commitlint')}}
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+{{/if}}
+{{#if (includes plugins 'vitest')}}
+    "@vitest/coverage-v8": "^3.2.4",
+{{/if}}
+{{#if (includes plugins 'changelog')}}
+    "compare-func": "^2.0.0",
+{{/if}}
+{{#if (includes plugins 'changelog')}}
+    "conventional-changelog-angular": "^8.0.0",
+    "conventional-changelog-cli": "^5.0.0",
+{{/if}}
+    "cross-env": "^10.0.0",
+    "esbuild": "^0.25.9",
+{{#if (includes plugins 'style')}}
+    "eslint": "^9.33.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "globals": "^16.3.0",
+{{/if}}
+    "husky": "^9.1.7",
+{{#if (includes plugins 'style')}}
+    "lint-staged": "^16.1.5",
+    "prettier": "^3.6.2",
+{{/if}}
+{{#if (includes plugins 'vitest')}}
+    "vitest": "^3.2.4",
+{{/if}}
+    "rimraf": "^6.0.1"
+  }
+}