MCP Time Server：把时区和时间换算交给标准工具

MCP Time Server：把时区和时间换算交给标准工具

基础概念

Time Server 是 MCP 官方 reference servers 里看起来最朴素，但实际上非常有用的一类。它解决的不是“问一句现在几点”，而是更通用的时间能力问题：

• 获取某个时区当前时间
• 在不同时区之间做换算
• 基于 IANA timezone 名称进行标准化处理
• 自动检测本机系统时区，必要时允许覆盖

官方 README 的定位很清楚：这是一个提供时间与时区转换能力的 MCP Server。

这类能力为什么值得单独做成 Server？因为时间问题看着简单，实际上是最容易被“拍脑袋字符串处理”写坏的一类问题之一。只要你涉及：

• 跨国家团队
• 定时任务
• 远程会议
• 时区差和夏令时

把时间换算交给标准工具，通常比让模型自己口算更稳。

核心要素

它真正解决的问题

为什么要强调 IANA 时区

这就是官方 README 一开始就把 IANA timezone names 写进工具参数说明的原因。

基础用法

最小启动方式

官方推荐的最简单方式是：

uvx mcp-server-time

如果你习惯 pip，也可以：

pip install mcp-server-time
python -m mcp_server_time

在 Claude Desktop 中挂载

官方 README 的最小配置是：

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
    }
  }
}

在 VS Code 中挂载

README 给出的 .vscode/mcp.json 形式是：

{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["mcp-server-time"]
      }
    }
  }
}

查某个时区现在几点

官方 README 给出的典型调用参数是：

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

返回结构里会包含：

• timezone
• datetime
• is_dst

这比只给一句“现在是下午几点”更适合程序和模型后续继续处理。

做时区换算

另一个常见调用是：

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

这类结果除了源时区和目标时区的结构化时间，还会给你：

• time_difference

也就是时差本身。

自定义本地时区

官方 README 还说明了一个实用配置：如果默认系统时区检测不适合你的运行环境，可以显式传：

{
  "command": "python",
  "args": [
    "-m",
    "mcp_server_time",
    "--local-timezone=America/New_York"
  ]
}

这对于容器、远程环境或者系统时区设置不干净的场景很有用。

同类工具对比

如果目标都是“让 AI 处理时间”，常见方式有三种：

核心区别：

• Time Server：最适合标准化、可复用的时间能力。
• 模型直接口算：适合很简单的问题，但不适合严肃时区换算。
• 通用脚本：可行，但你得自己设计工具接口和跨客户端复用方式。

常见误区

优劣势分析

思考题

参考资料

1. 官方 Time reference server README：https://github.com/modelcontextprotocol/servers/tree/main/src/time（查询日期 2026-04-11）
2. 官方 Reference Servers 仓库：https://github.com/modelcontextprotocol/servers（查询日期 2026-04-11）