Create-MCP-Kit

Features

Usage

npm create mcp-kit@latest

yarn create mcp-kit@latest

pnpm create mcp-kit@latest

Project Types

MCP Server

Server Project Structure

The generated server project will have the following structure:
├── src/
│ ├── tools/ # MCP tools implementation
│ │ ├── index.ts # Tools registration
│ │ └── register*.ts # Individual tool implementations
│ ├── resources/ # MCP resources implementation
│ │ └── index.ts # Resources registration
│ ├── prompts/ # MCP prompts implementation
│ │ └── index.ts # Prompts registration
│ ├── services/ # Server implementations
│ │ ├── stdio.ts # STDIO transport implementation
│ │ └── web.ts # Streamable HTTP and SSE transport implementation
│ └── index.ts # Entry point
├── tests/ # Test files (optional)
├── scripts/ # Build and development scripts
├── .github/ # GitHub Actions workflows (optional)
├── .husky/ # Git hooks (optional)
├── .prettierrc # Prettier configuration (optional)
├── changelog-option.js # Conventional changelog config (optional)
├── commitlint.config.js # Commit message lint rules (optional)
├── eslint.config.js # ESLint configuration (optional)
├── lint-staged.config.js # Lint-staged configuration (optional)
├── vitest.*.ts # Vitest configuration (optional)
└── package.json

Server Development Scripts

MCP Client

Client Project Structure

The generated client project will have the following structure:
├── src/
│ └── index.ts # Entry point with transport implementations
├── tests/ # Test files (optional)
├── scripts/ # Build and development scripts
├── .github/ # GitHub Actions workflows (optional)
├── .husky/ # Git hooks (optional)
├── .prettierrc # Prettier configuration (optional)
├── changelog-option.js # Conventional changelog config (optional)
├── commitlint.config.js # Commit message lint rules (optional)
├── eslint.config.js # ESLint configuration (optional)
├── lint-staged.config.js # Lint-staged configuration (optional)
├── vitest.*.ts # Vitest configuration (optional)
└── package.json

Client Development Scripts

Features

MCP Server Features

Transport Modes

MCP Tools

// Full implementation example
import { z } from 'zod'
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
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: 'Invalid keyword',
 }
 }
 return {
 success: true,
 data: `Data for ${keyword}`,
 }
}

MCP Resources

// Full implementation example
import { type 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}`,
 },
 ],
 }
 },
 )
}

MCP Prompts

// Full implementation example
import { z } from 'zod'
import type { 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}`,
 },
 },
 ],
 }
 },
 )
}

MCP Client Features

Multiple Transport Modes

// Import the MCP client
import { McpClient } from '@modelcontextprotocol/sdk/client/mcp.js'
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/transports/stdio.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/transports/streamable-http.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/transports/sse.js'
// Create a new MCP client
const client = new McpClient()
// STDIO Transport
const stdioClientTransport = new StdioClientTransport({
 command: 'npx',
 args: ['-y', '@my-mcp-hub/node-mcp-server'],
 env: process.env,
})
await client.connect(stdioClientTransport)
// Streamable HTTP Transport
const streamableBaseUrl = new URL('http://localhost:8401/mcp')
const streamableClientTransport = new StreamableHTTPClientTransport(streamableBaseUrl)
await client.connect(streamableClientTransport)
// SSE Transport
const sseBaseUrl = new URL('http://localhost:8401/sse')
const sseClientTransport = new SSEClientTransport(sseBaseUrl)
await client.connect(sseClientTransport)

Tool Calling

// List available tools
const tools = await client.listTools()
console.log(tools)
// Call a tool
const callResult = await client.callTool({
 name: 'GetData',
 arguments: {
 keyword: 'Hello',
 },
})
console.log(callResult.content)

Resource Access

// List available resources
const resources = await client.listResources()
console.log(resources)
// Get a resource
const resource = await client.getResource('search://example')
console.log(resource.contents)

Prompt Usage

// List available prompts
const prompts = await client.listPrompts()
console.log(prompts)
// Use a prompt
const prompt = await client.getPrompt('echo', { message: 'Hello, world!' })
console.log(prompt.messages)

Contributing

Contributors

License