从零开始构建自定义 MCP Server

准备工作

本教程将带你从零开始构建一个 MCP Server。你需要：

Node.js 20+

TypeScript 5.x

基本的 AI Agent 概念了解

第一步：初始化项目

mkdir my-mcp-server
cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk

第二步：定义工具

MCP Server 的核心是定义「工具」。每个工具都有名称、描述和输入参数的 JSON Schema。

const tool = {
  name: "get_weather",
  description: "获取指定城市的天气信息",
  inputSchema: {
    type: "object",
    properties: {
      city: { type: "string", description: "城市名称" }
    },
    required: ["city"]
  }
};

第三步：实现处理逻辑

每个工具都需要一个对应的处理函数，接收用户输入并返回结果。

第四步：启动服务器

使用 MCP SDK 提供的 Server 类即可快速启动：

const server = new Server({ name: "my-server", version: "1.0.0" });
server.start();

部署建议

小型项目：Cloudflare Workers

中型项目：Railway / Fly.io

企业级：自建 Docker 容器