用户提问 → AI 模型 → 调用 MCP Tool → MCP 服务执行 → 返回结果 → AI 组织回复 → 用户看到答案

server.registerTool(
  "tool_name",         // 1. 工具名称（AI 通过此名称调用）
  {
    title: "...",       // 2a. 展示名称
    description: "...", // 2b. 功能描述（★ AI 据此决定何时调用，写得越清楚越好）
    inputSchema: {},    // 2c. 参数定义（Zod schema，AI 据此传参）
  },
  handler              // 3. 执行函数（接收参数，返回结果）
);

npm install

# 开发模式（文件变更自动重启）
npm run dev

# 生产模式
npm run start

{
  "mcpServers": {
    "f1-latest-cn": {
      "command": "node",
      "args": ["src/server.js"],
      "cwd": "/your/path/to/f1-latest-cn-mcp"
    }
  }
}

src/
├── server.js                 # 入口：创建 MCP 服务、连接传输层
├── config/
│   ├── constants.js          # 全局常量（服务名称、超时、日志级别）
│   └── error-codes.js        # 统一错误码定义与映射
├── tools/
│   ├── index.js              # Tool 自动注册（扫描目录、动态 import）
│   ├── health.js             # health_check —— 健康检查
│   ├── time.js               # format_time —— 时间格式化
│   └── f1-latest.js          # f1_latest_news —— F1 新闻查询（支持分页）
└── utils/
    ├── http.js               # axios 封装（统一超时配置）
    ├── logger.js             # 日志工具（输出到 stderr）
    ├── response.js           # MCP 标准响应构造器
    └── safe-tool.js          # Tool 安全执行包装器（统一 try-catch + 日志）

{ "input": "2026-02-28 10:00:00", "format": "YYYY/MM/DD HH:mm" }

import * as z from "zod/v4";
import { createSafeToolHandler } from "../utils/safe-tool.js";
import { createSuccessResult } from "../utils/response.js";

export const registerWeatherTool = (server) => {
  server.registerTool(
    "get_weather",                              // 工具名称
    {
      title: "Get Weather",
      description: "查询指定城市的天气",         // AI 据此决定何时调用
      inputSchema: {
        city: z.string().describe("城市名称"),   // AI 据此传参
      },
    },
    createSafeToolHandler("get_weather", async ({ city }) => {
      // 你的业务逻辑...
      const weather = await fetchWeather(city);
      return createSuccessResult({ city, weather });
    }),
  );
};