/ 目录 / 演练场 / Time
● 官方 modelcontextprotocol ⚡ 即开即用

Time

作者 modelcontextprotocol · modelcontextprotocol/servers

小巧的 MCP,解决真实的烦恼——不用浏览器标签页就能问'柏林现在几点?'和'伦敦下午 3 点太平洋时间合适吗?'

参考级别的时区 MCP。两个工具:获取任何 IANA 时区的当前时间,以及在时区之间转换特定时间。解决 Claude 经常答错的日程问题和 DST 边界情况,因为它的训练数据有时间截断。

为什么要用

核心特性

实时演示

实际使用效果

time.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "time",
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "time": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-server-time"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add time -- uvx mcp-server-time

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Time

找到跨 4 个时区都合适的会议时间

👤 任何与分布式团队安排日程的人 ⏱ ~3 min beginner

何时使用: 你需要找到一个 30 分钟的时间段,不能是某人的 6am 或另一个人的 10pm。

步骤
  1. 让 Claude 了解真实的当前时间
    America/Los_Angeles、America/New_York、Europe/London 和 Asia/Tokyo 现在分别几点?✓ 已复制
    → 四个准确的时间,而不是过时的猜测
  2. 转换候选时间段
    下周二 10:00 America/Los_Angeles 转换到其他 3 个时区。如果对任何人来说超出 8am-7pm 本地时间,标记出来。✓ 已复制
    → 4 行表格,标记超时的情况
  3. 提议 2 个人道的时间段
    建议 2 个每周重复的时间段,让所有人都在本地 8am-6pm 内。不要选择需要某人周末工作的时间。✓ 已复制
    → 两个可行的选项,各有权衡

结果: 一个人道的会议时间,转换计算清晰展示,可直接用作日历邀请。

注意事项
  • DST 转换在进行中途改变时差 — 总是用 IANA 时区名称(America/Los_Angeles),不要用 'UTC-8' 这样的时差,因为在 DST 变化时会过时。
  • 半小时时差的时区(印度、尼泊尔、澳大利亚部分地区) — 信任工具——它能处理这些;不要让 Claude 四舍五入到整数小时

通过将日志时间转换到本地时区来调试时间戳 bug

👤 排查问题时读取 UTC 日志的工程师 ⏱ ~5 min beginner

何时使用: 你的日志是 UTC,但你在太平洋时区,事件关联总是出错。

步骤
  1. 转换事件窗口
    将 2026-04-14T22:37:00Z 转换到 America/Los_Angeles。也给我 Europe/Amsterdam 的同一时刻,我们的 oncall ops 在那里。✓ 已复制
    → 两个本地时间并排显示
  2. 确认 DST 状态
    DST 在那一刻在 America/Los_Angeles 有效吗?UTC 时差是多少?✓ 已复制
    → 打印时差(如 -07:00),确认 DST
  3. 与人类事件关联
    已知事件是 15:37 PT,这与 Slack 线程中的 'Monday afternoon' 对应吗?✓ 已复制
    → 对照人类命名的时间进行的理智检查

结果: 你不再怪错部署,因为你终于有了正确的时间。

注意事项
  • 混用 'Z'、'+00:00' 和无时区的时间戳 — 总是先转换到显式 UTC;拒绝任何没有时区的时间戳
搭配使用: sentry · postgres

组合

与其他 MCP 搭配,撬动十倍杠杆

time + sentry

将事件开始/结束时间转换到本地时区用于事后回顾讲述

对于 Sentry 事件 INC-42,将开始和结束时间戳转换到 America/Los_Angeles 和 Europe/Berlin,并写出事后回顾的时间线。✓ 已复制
time + postgres

当数据库存储 UTC 时,用正确的本地日期边界查询

2026-04-13 America/Los_Angeles 本地时间有多少注册?用时间工具计算 UTC 范围,然后查询事件。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
get_current_time timezone: str (IANA name, e.g. 'Europe/Berlin') 在任何日期推理前,让模型了解真实的墙上时钟时间 free
convert_time source_timezone: str, time: str (HH:MM), target_timezone: str 在两个时区之间转换特定的时间 free

成本与限制

运行它的成本

API 配额
无——纯本地计算
每次调用 Token 数
极小——每次调用几百个 token
费用
免费
提示
无预算问题。任何涉及日期的地方都可以自由调用。

安全

权限、密钥、影响范围

凭据存储:
数据出站: 无——仅读取主机系统时钟和 tzdata

故障排查

常见错误与修复

Unknown timezone: 'PST'

用 IANA 名称,不要用缩写。'PST' → 'America/Los_Angeles'。'EST' → 'America/New_York'。缩写容易有歧义(IST = 印度还是爱尔兰?)。

Returned time seems an hour off

DST 转换边界情况。用 is_dst 字段验证——如果错了,说明主机的 tzdata 过时了。更新系统时区数据库。

验证: zdump -v America/Los_Angeles | head
convert_time returns 'ambiguous time' during DST fall-back

时钟小时发生两次(1:30am 运行两次)。指定日期时间,而不仅仅是时间,以确保转换无歧义。

替代方案

Time 对比其他方案

替代方案何时用它替代权衡
专门的日历 MCP(Google Calendar)你想真正预订会议,而不仅仅是计算时间更重型、需要 OAuth——但能完整完成邀请流程

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills