MCP Server Scaffolding Tool

A command - line tool for quickly creating standardized MCP (Model Context Protocol) servers using Node.js

✨Features

🛠️ Interactive Configuration

• Provides a user
• friendly command
• line interactive interface

📦 Multi - level API Support

• Supports both High
• Level and Low
• Level API development

⚡ Rapid Generation

• Fast project generation based on a template engine

🔧 Intelligent Configuration

• Automatically generates package.json and TypeScript configurations

🚀 Quick Start

Create a Project

1
2# by npx
3npx create-ts-mcp-server your-server-name
4

Initialization Steps of CLI

# config your project name
? What is the name of your MCP (Model Context Protocol) server? (your-mcp-server-name)
# config your project description
? What is the description of your server? (A Model Context Protocol server)
# @modelcontextprotocol/sdk API level，High-Level upper layer encapsulation of simple and easy-to-use API (suitable for most simple scenarios, more recommended), Low-Level API for underlying detail processing is suitable for complex scenarios
? What is the API level of your server?
 High-Level use (Recommended): It is a commonly used and encapsulated interface for developers. It shields many complex details, is easy to use, and is suitable for most scenarios.
 Low-Level use: It is a low-level interface, which is suitable for developers who need to customize the implementation details. (Use arrow keys)
❯ High-Level API
  Low-Level API
# config your server transport type
? What is the transport type of your server?
 Standard Input/Output (stdio):The stdio transport enables communication through standard
input and output streams. This is particularly useful for local integrations and command-line
 tools.
 Server-Sent Events (SSE):SSE transport enables server-to-client streaming with HTTP POST
requests for client-to-server communication. 
❯ Standard Input/Output (stdio)
  Server-Sent Events (SSE)
# success message
✔ MCP server created successfully!

Next steps:
  cd your-mcp-server-name
  npm install
  npm run build  #  build your server first
  npm run inspector # debug your server

Develope Command

1cd your-server-name
2
3npm install # install dependencies
4
5npm run build # build project
6
7npm run inspector # stdio: type debug your server
8
9npx tsx ./src/index.ts # sse: run your sse server
10

Directory Structure

The typical project structure generated is as follows:

your-server-name/
├── src/
│   ├── server     
│       ├── server.ts # mcp server
│   ├── index.ts      # Service entry file
├── package.json
└── tsconfig.json

📚 API Level Explanation

High-Level API

Use cases: Rapid development of standard services Features:

Pre-configured common middleware Automatic error handling Standardized routing configuration Out-of-the-box RESTful support

Example:

1// Quickly create a service instance
2server.tool(
3  "calculate-bmi",
4  {
5    weightKg: z.number(),
6    heightM: z.number()
7  },
8  async ({ weightKg, heightM }) => ({
9    content: [{
10      type: "text",
11      text: String(weightKg / (heightM * heightM))
12    }]
13  })
14);

Low-Level API

Use cases: Scenarios requiring deep customization Features:

Full control over the request lifecycle Manual management of the middleware chain Custom protocol handling Low-level performance optimization

Example:

1server.setRequestHandler(CallToolRequestSchema, async (request) => {
2  switch (request.params.name) {
3    case "create_note": {
4      const title = String(request.params.arguments?.title);
5      const content = String(request.params.arguments?.content);
6      if (!title || !content) {
7        throw new Error("Title and content are required");
8      }
9
10      const id = String(Object.keys(notes).length + 1);
11      notes[id] = { title, content };
12
13      return {
14        content: [{
15          type: "text",
16          text: `Created note ${id}: ${title}`
17        }]
18      };
19    }
20
21    default:
22      throw new Error("Unknown tool");
23  }
24});