AI导哈

MCP服务器脚手架工具

一个用于快速创建标准化MCP（Model Context Protocol）服务器的命令行工具，支持交互式配置和多级API开发。

  • by Makoq
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 makoq/create-mcp-server-ts

使用说明

MCP服务器脚手架工具

一个使用Node.js快速创建标准化MCP（模型上下文协议）服务器的命令行工具

✨特性

🛠️ 交互式配置

  • 为用户提供
  • 友好指挥
  • 线路交互界面

📦 多级API支持

  • 同时支持High
  • 水平和低
  • API开发水平

⚡ 快速生成

  • 基于模板引擎的快速项目生成

🔧 智能配置

  • 自动生成package.json和TypeScript配置

快速开始

npx create-ts-mcp-server your-mcp-server-name

🚀 使用指南

创建项目


# by npx

npx create-ts-mcp-server your-server-name

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
# 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

发展指挥

cd your-server-name

npm install # install dependencies

npm run build # build project

npm run inspector # debug your server

目录结构

生成的典型项目结构如下：

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

📚 API等级说明

高级API

用例：快速开发标准服务功能：

预配置的通用中间件 自动错误处理 标准化路由配置 开箱即用的RESTful支持

例子：

// Quickly create a service instance
server.tool(
  "calculate-bmi",
  {
    weightKg: z.number(),
    heightM: z.number()
  },
  async ({ weightKg, heightM }) => ({
    content: [{
      type: "text",
      text: String(weightKg / (heightM * heightM))
    }]
  })
);

API低水平

用例：需要深度定制的场景功能：

对请求生命周期的完全控制 中间件链的手动管理 自定义协议处理 低级性能优化

例子：

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  switch (request.params.name) {
    case "create_note": {
      const title = String(request.params.arguments?.title);
      const content = String(request.params.arguments?.content);
      if (!title || !content) {
        throw new Error("Title and content are required");
      }

      const id = String(Object.keys(notes).length + 1);
      notes[id] = { title, content };

      return {
        content: [{
          type: "text",
          text: `Created note ${id}: ${title}`
        }]
      };
    }

    default:
      throw new Error("Unknown tool");
  }
});

相关 MCP