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 查询 Asia/Shanghai 当前时间,再把当天的 14:00 Asia/Shanghai 分别转换为 UTC、America/New_York 和 Europe/London;列出工具返回的日期和夏令时状态,不指定历史或未来日期。
6. 不要创建、修改、删除、发送内容,也不要连接生产环境;需要写权限或更高权限时先征求我确认。- 复制完整指令,发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境;遇到 Token、项目 ID、路径或其他占位符时,应停下来向你确认。
- 接入后运行
codex mcp list,再用 Time MCP Server 的小范围测试任务回读结果。
第一次调用示例
登记完成后,新开一个任务,按下面任务限定调用范围,先说清目标、范围和停止条件。
发给 Codex
第一次小范围任务
请先用 Time MCP 查询 Asia/Shanghai 当前时间,再把当天的 14:00 Asia/Shanghai 分别转换为 UTC、America/New_York 和 Europe/London;列出工具返回的日期和夏令时状态,不指定历史或未来日期。怎样算成功
返回工具支持的当前日期、IANA时区和换算结果;该工具未提供任意日期参数,不能用来保证历史或未来日期排期。
- 明确给出源时区和目标时区。
- 先查询当前时间,再进行转换。
- 把结果与操作系统时钟或权威时钟核对。
- 涉及截止时间时同时保留原时区和转换后时间。
权限与安全
凭证与连接方式
本地 stdio;不需要账号,时区请使用 Asia/Shanghai 这类 IANA 名称。
- 通常不需要业务账号,但会暴露任务中的时间与时区上下文
- 错误时区名称会得到错误排期
- 定时执行仍需由实际调度系统负责
