如何在 10 分钟内构建你的第一个 MCP server

Original title: How to build your first MCP server in 10 minutes

The title and summary in the selected language are awaiting translation.

AI overview

用 `npx create-mcp-server` 脚手架生成 TypeScript 项目，在 `src/index.ts` 里替换示例工具即可定义自己的 MCP 工具，再 `npm run build`、`npm start` 并接入 Claude Desktop 配置。

Full text

I built my first MCP server last week and it was way simpler than I expected. Here is exactly how, no fluff.

Prerequisites

Node.js 20+
10 minutes

Step 1: Scaffold

npx create-mcp-server my-first-server
cd my-first-server
npm install

This generates a complete TypeScript project with one example tool.

Step 2: Add your tool

Open src/index.ts. Replace the hello tool with whatever you want:

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;

  if (name === 'current_time') {
    return {
      content: [{ type: 'text', text: new Date().toISOString() }]
    };
  }

  throw new Error(`Unknown tool: ${name}`);
});

Step 3: Build and connect

npm run build
npm start

Add to Claude Desktop config and you are done.

The whole thing took me 8 minutes. Most of that was reading the docs.

What I learned

The MCP SDK handles all the transport layer — you just define tools
StdioServerTransport means your server runs as a subprocess. No HTTP, no port conflicts
Error handling is important. If your tool crashes, the whole MCP connection breaks

Want to try it?

npm install -g mcp-hub
mcp-hub search mcp