Time MCP Server 是什么?
Time MCP Server 是提供当前时间和时区转换的轻量工具。它让 Codex 调用真实时钟并使用 IANA 时区计算,避免跨地区排期和日志核对时靠模型猜时间。
一句话理解提供当前时间与时区转换,避免在跨时区排期和日志核对中靠模型猜测。
为什么需要它?
把当前时间和时区换算交给可执行工具,减少夏令时和本地时区误差。
接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。
核心能力
读取指定时区当前时间
把真实信息带回当前任务,减少反复复制和手动核对。
在 IANA 时区之间转换
在明确授权范围内调用工具,并保留执行过程和结果。
为日志和排期提供明确时间基准
回读来源、状态与限制,方便继续处理和人工验收。
适合谁?怎么用?
- 核对时区、当前时间和跨区排期
- 处理跨时区会议、日志时间、截止时间或定时流程的用户。
- 返回 IANA 时区、转换结果和日期变化,不再依赖模型心算。
- 不适合替代业务系统的最终排期或交易时间校验。
- 通常不需要业务账号,但会暴露任务中的时间与时区上下文
- 错误时区名称会得到错误排期
怎么接入?
- 1准备
安装并确认
uvx可用。 - 2授权
运行
uvx mcp-server-time检查参考服务器能否启动。 - 3连接
在客户端登记
uvx与mcp-server-time参数。 - 4开始使用
重新加载后查询本地时区和一个目标时区的当前时间。
安装命令
添加 Time MCP Server
codex mcp add time -- uvx mcp-server-time需要先安装 uv/uvx。时区使用 IANA 名称,例如 Asia/Shanghai。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时,把下面整段发给 Codex。它会先核对官方说明和前置条件,遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Time MCP Server
请帮我在当前电脑上接入并验证 Time MCP Server。
官方来源:https://github.com/modelcontextprotocol/servers/tree/main/src/time
目标接入命令:codex mcp add time -- uvx mcp-server-time
请按以下步骤执行:
1. 先阅读官方 README,核对当前推荐接入方式与上述命令。如果官方说明已经变化,先告诉我差异,不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证,也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符,先列出需要我提供的值并停下来,不要自行猜测。
4. 条件满足后执行接入命令,再运行 codex mcp list,确认 Time MCP Server 已登记,并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接:请用 Time MCP 把 2026-08-09 14:00 Asia/Shanghai 转成 UTC、纽约和伦敦时间,并说明夏令时。
6. 不要创建、修改、删除、发送内容,也不要连接生产环境;需要写权限或更高权限时先征求我确认。- 复制完整指令,发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境;遇到 Token、项目 ID、路径或其他占位符时,应停下来向你确认。
- 接入后运行
codex mcp list,再用 Time MCP Server 的只读首测任务回读结果。
第一次调用示例
登记完成后,新开一个任务,先用下面这句做只读验证,把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Time MCP 把 2026-08-09 14:00 Asia/Shanghai 转成 UTC、纽约和伦敦时间,并说明夏令时。怎样算成功
返回 IANA 时区、转换结果和日期变化,不再依赖模型心算。
- 明确给出源时区和目标时区。
- 先查询当前时间,再进行转换。
- 把结果与操作系统时钟或权威时钟核对。
- 涉及截止时间时同时保留原时区和转换后时间。
权限与安全
凭证与连接方式
本地 stdio;不需要账号,时区请使用 Asia/Shanghai 这类 IANA 名称。
- 通常不需要业务账号,但会暴露任务中的时间与时区上下文
- 错误时区名称会得到错误排期
- 定时执行仍需由实际调度系统负责
