Time MCP ServerTime MCP Server
只做两件事:查当前时间、换时区。无文件无网络,是权限风险最低的一类 server。
Does two things only: report the current time and convert time zones. No files, no network — the lowest-risk category of server.
适合与不适合When to use it, when not to
| 场景 | 是否适合 |
|---|---|
| 日程安排需要准确时间 | ✅ |
| 跨时区协作 | ✅ |
| 避免模型编造时间 | ✅ |
| 做定时任务 / 调度 | ❌ 它只查询时间,不调度 |
最后一条是常见误解——名字叫 time,容易以为能做定时。 实际它只回答「现在几点」和「A 时区的 X 点是 B 时区几点」。
Scenarios where an agent needs the current date and time to reason about scheduling, logs or freshness.
Not a fit for anything beyond time — it is one tool with one narrow purpose.
中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-20
- 出品属地Origin
- 国外出品foreign-made 国外主体(网信办公示名单未见对应备案主体)。foreign entity (no matching filing entity in the CAC registry).
- 国内使用Direct access
- 大陆可直连direct OK 官网仓库在 GitHub,大陆直连波动(同日实测 200/000 混合);npm / PyPI 安装源实测稳定可达。Hosted on GitHub — direct reachability from mainland fluctuates (200/000 mixed on the same day); npm / PyPI install routes measured stable.
- 备案状态CAC filing
- 未见于备案名单not in filing list:未见于网信办公示名单(2026-10-20 检索 13 批附件,https://www.cac.gov.cn/2024-04/02/c_1713729983803145.htm);该产品未面向大陆公众提供服务,备案不适用。not in the CAC public registry (13 batch attachments searched 2026-10-20, https://www.cac.gov.cn/2024-04/02/c_1713729983803145.htm); the product does not serve the mainland public, so filing does not apply.
备案信息以网信办《生成式人工智能服务已备案信息》公示名单为准(按批次滚动更新,本站只抄编号不解读);「大陆可直连」是本站从大陆网络直连实测的结果,不是厂商承诺。GitHub 类站点当日实测有波动,口径写在依据里。Filing status is quoted from the CAC public registry (updated batch by batch; this site copies the number and does not interpret it). "Direct access" is this site's own reachability measurement from a mainland network, not a vendor promise. GitHub-hosted sites fluctuated on the measurement day — the note says so.
固定坐标系Fixed coordinate system
11 个维度dimensions, 与同分区其他对象逐项可比each comparable item by item against others in the same section.
- 模型与开放条件Model & openness
本身不调用模型,是被客户端调用的接口实现。 使用 IANA 时区名,支持系统时区自动检测。
- 运行位置Where it runs
本地 Python 进程,通过 stdio 通信。
依赖 Python MCP SDK 1.x(要求 mcp=1.29.0,2),SDK 2.0 重命名了该 server 使用的 API。
2026-08-30 修复了容器 bind mount 在 Docker / Podman / SELinux 下的安全与兼容问题。
推荐用 uvx 直接运行,无需预安装。
- 本地文件Local files
无任何文件访问能力。不涉及文件读写。
- 关机后的任务Tasks after shutdown
不支持。单次时间查询为同步操作,随客户端进程结束。
- 工具与扩展Tools & extensions
提供 2 个工具:
get_current_time(按指定时区取当前时间) 与convert_time(时区间转换)。 输出为结构化时间数据,可直接消费。- 上下文与记忆Context & memory
无状态。每次调用独立,不保留历史。
- 权限与限制Permissions & limits
无实质权限风险:不访问文件、不访问网络、不写任何状态。 全部权限是「能查询当前时间和做时区换算」。
- 适合什么任务Best for
给 Agent 提供可靠的时间与时区换算能力。 适合需要避免模型猜时间的场景(如日程、跨时区协作)。
- 传输方式Transport
支持 stdio,并提供容器部署方式(Docker / Podman)。
2026-08-30 修复 bind mount 安全与兼容问题(含 SELinux),与 fetch、git 属同一条修复 commit(#2205)。
官方 README(2026-10-08 全文核验)只给本地进程接入(uvx / pip / Docker),没有远程传输的官方启动方式。
- 认证机制Authentication
无独立认证层,但本 server 无任何外部资源访问, 认证与否不影响安全。
- 权限范围Permission scope
无文件与网络访问,不读不写任何外部资源。 与 sequential-thinking 同属权限风险最低的一类,可放心在敏感环境使用。
头号误解Top misconception
- 以为模型自己知道准确时间,需要它取系统时间而非猜Assuming the model already knows the exact time — it needs this to read the system clock rather than guess
- 以为能用它做定时任务,它只查询时间,不调度Assuming it can schedule tasks — it only reads the time, it does not schedule
未知项清单Known unknowns
- 是否支持 Streamable HTTP(仓库未声明)
- 容器形态下的认证配置
- 是否支持夏令时切换的边界情况处理
证据来源Evidence sources
判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-08,内容更新日content updated on 2026-10-08。
| 类型Type | 名称Name | 链接Link |
|---|---|---|
| docs | MCP · Time Server | https://github.com/modelcontextprotocol/servers/tree/main/src/time |
| changelog | MCP · Time 目录变更历史 | https://github.com/modelcontextprotocol/servers/commits/main/src/time |
| changelog | MCP · Servers Releases | https://github.com/modelcontextprotocol/servers/releases |
| repo | MCP · Servers 仓库 README(生产环境免责声明) | https://github.com/modelcontextprotocol/servers |
实测记录Measured runs
本站尚未完成实测。测试协议见 tasks/_protocol.md。
变更记录说明
本对象无独立 changelog 页,变更记录在目录 commit 历史中:
| 日期 | 内容 |
|---|---|
| 2026-08-30 | 修复容器 bind mount 安全与兼容问题(与 fetch、git 同一条 commit #2205) |
| 2026-08-18 | 文档补充 Python MCP 1.x 版本要求 |
注意:SDK 2.0 重命名了该 server 使用的 API,官方锁在 mcp>=1.29.0,<2。 如果你的环境装了 SDK 2.x,这个 server 可能起不来。
工具清单
| 工具 | 参数 | 说明 |
|---|---|---|
get_current_time | timezone(IANA 名) | 取指定时区的当前时间 |
convert_time | source_timezone time(HH:MM) target_timezone | 时区换算 |
用 IANA 时区名(如 America/New_York),不是 UTC 偏移量。 这也是它比「让模型自己算时区」可靠的地方——IANA 名带夏令时规则。
权限评价
MCP server 里权限风险最低的一类:
| 检查项 | 结果 |
|---|---|
| 读文件 | ❌ 无 |
| 写文件 | ❌ 无 |
| 访问网络 | ❌ 无 |
| 持久化状态 | ❌ 无 |
| 删除能力 | ❌ 无 |
全部权限就是「能问系统现在几点」。这类 server 值得单独指出—— 它说明 MCP 生态里也有零风险工具。
安装
官方推荐 uvx 直接运行,无需预安装: ``bash uvx mcp-server-time ` 也支持 pip install mcp-server-time`。
相关条目Related entries
- Sequential Thinking MCP Server同属零风险一类
- Everything MCP Server测试用 server,不适合生产
- ClineCline另一层 · 现成的 AI 工具Other layer · Ready-made AI tools
本页由This page is generated from the ai-agent-guide 数据层生成(CC BY 4.0)。data layer (CC BY 4.0).
方法论与坐标系定义见仓库内 METHODOLOGY.md。