Trae 中 Time MCP 服务器配置全解析

MCP 与 Trae 的协同生态

MCP（Model Context Protocol）旨在为大型语言模型提供统一的“工具调用”语义层，让代理像调用本地函数一样安全访问外部程序、数据库乃至硬件设备。Trae IDE 在 1.3.0 版本起正式拥抱 MCP 特性，开发者可以通过项目级 .trae/mcp.json 或用户级配置为智能助手挂载任意数量的 MCP 服务器，从而动态扩展 IDE 能力 (docs.trae.ai)。

与早期各家 IDE“私有插件”模式不同，MCP 关注在传输层与消息格式做最小约束：服务器默认走 stdio 管道，也支持 SSE 与 Streamable HTTP；单条消息即一行 JSON，字段 name 标识要调用的工具，arguments 列出实参 (raw.githubusercontent.com)。这种极简设计保证了组件可移植性，也让 LLM 侧路由逻辑高度简洁——无需关心复杂握手或鉴权过程，直接写一行 JSON 即可完成调用。

认知 uvx：零安装临时环境执行器

想要快速分发 MCP 服务器，最普遍的痛点是“依赖安装”。Astral 的 uv 工具通过内置超高速解析与二进制缓存，提供了 uvx（uv tool run 的别名）命令：一次性创建隔离环境、解析依赖、执行工具，进程退出后自动清理目录 (docs.astral.sh, docs.astral.sh)。
其机制与 pipx 类似，却在解析速度、缓存复用与并行下载上全面超越 pip；实测 100+ 依赖级联的场景依旧能在两秒内启动 (sixfeetup.com, github.com)。对需要“即用即走”的 MCP 服务器而言，uvx 几乎是天然拍档：一次启动便能保证依赖完整，不会污染宿主 Python 环境。

认识 mcp-server-time：LLM 的时区大脑

mcp-server-time 属于官方参考实现集合里“时间”分类的服务器，提供 get_current_time 与 convert_time 两个工具，分别用于获取指定 IANA timezone 当前时间，和执行时区转换 (github.com, raw.githubusercontent.com)。

• get_current_time 接收 timezone 字符串，若缺省则回落到服务器起动时的 --local-timezone 值或系统时区。

• convert_time 需要 source_timezone、time（24h HH:MM）与 target_timezone，返回两侧时间戳及相差小时数。

正因其无状态、幂等、易部署的特性，该服务器被广泛用在 Claude、Cursor、Zed、JetBrains AI Assistant 等多款 IDE 与聊天应用中，用作“环境时区感知”基础设施 (mcp.so, jetbrains.com)。

配置文件字段逐个剖解

对应本文开头的 Trae 片段：

{
  "mcpServers": {
    "Time": {
      "command": "uvx",
      "args": [
        "mcp-server-time",
        "--local-timezone=Asia/Shanghai"
      ],
      "env": {}
    }
  }
}

由于行内双引号已用 ` 替换，下文解释中所引 JSON 键值皆以反引号包裹，真正运行请参照上方代码块或本文附带脚本。

字段	作用	细节解析
mcpServers	Trae 全局 MCP 服务器表	键名为自定义逻辑别名，可被 Trae 侧路由直接引用。
Time	该服务器在 Trae 侧的实例名	取名大写首字母纯属习惯，保持与后端工具包 README 示例一致。
command	启动器	采用 uvx，意味着不必提前 pip install mcp-server-time。
args	启动参数数组	第一段工具名 mcp-server-time，后跟一枚可选标志 --local-timezone=Asia/Shanghai。
env	传递给子进程的环境变量	本例为空，但可放置诸如 TZDB_CACHE_DIR 等自定义路径。

--local-timezone 的策略意义

部署机器常因 Docker 或 WSL 导致系统时区被置为 UTC，若不显式指定，mcp-server-time 默认回退到系统时区，容易让 LLM 返回“本地时间”却与用户预期失配 (raw.githubusercontent.com, docs.openwebui.com)。通过显式参数把时区钉死为 Asia/Shanghai，可确保输出一致性；同时传入此参数并不限制服务器对其他时区的查询与转换，只是让“空 timezone”场景默认走上海时间。

完整可运行示例

笔者使用 python_user_visible 工具生成了一份脚本，可在任意已安装 uv 的环境直接运行。脚本启动 MCP 服务器，连续演示“查询东京当前时间”与“把上海 15:00 转换到伦敦”两种调用：

点此下载 demo Python 脚本

设计要点：

1. 通过 subprocess.Popen 打开 uvx mcp-server-time，建立标准输入输出双工管道。

2. 每条请求都以一行 JSON 写入 stdin 并立即 flush；服务器按行返回 JSON。

3. 示例里读 stdout.readline() 后打印，可视化交互结果。

如需嵌入 Trae，只需将上述 JSON 片段保存为 ~/.trae/mcp.json（或项目根 .trae/mcp.json），随后在 Chat 窗口输入：

/tool Time.get_current_time timezone=Europe/London

Trae 会自动路由请求至本地 MCP 进程，并把返回值插入对话上下文。

真实世界案例：跨国项目晨会排期

假设一家位于上海的创业团队与纽约、伦敦研发中心协作，需要在工作日安排每日站会，要求三地均处于 9:00–18:00 之间。传统做法通常需要手工对照时区表，而有了上文配置，项目助理只需在 Trae 对话里提出：

请帮我找一个上海、伦敦、纽约都方便的开会时间，长度 30 分钟。

LLM 会先调用 get_current_time 三次确认当前当地时间，再枚举出未来 24 小时的整／半点，利用 convert_time 快速计算各落点对应三地时段是否落在工作区间，最终返回如“北京时间 22:30 / 伦敦 15:30 / 纽约 10:30”这样的候选列表。整个过程不依赖外部 API，数据全在本机完成，速度与隐私兼顾 (aibase.com, reddit.com)。

延伸话题：把 MCP 暴露为 REST 服务

如果开发团队想让云端应用也复用本地工具，可在服务器后再套一层 mcpo 代理，将 stdio 协议转换为标准 OpenAPI HTTP 接口：

uvx mcpo --port 8000 -- uvx mcp-server-time --local-timezone=Asia/Shanghai

启动后便可通过 http://localhost:8000/docs 查看 Swagger 文档，远程调用无需安装 Python 或 uv 环境 (docs.openwebui.com)。

结语

以上从 MCP 协议理念到 Trae 实际配置，再到 uvx 与 mcp-server-time 的运行细节，为读者系统性梳理了那段简短 JSON 的深层含义及工程价值。通过在本地轻量启动一个“时区大脑”，不仅让 LLM 能够给出更贴合场景的答案，也让跨时区协作流程自动化升级。配合 Trae 的上下文聚合能力，开发者在任何代码或文档里提及时间都能即时获得转换与校验，真正把智能助理的边界延伸到“真实世界的时钟”。

当你下次需要处理时区逻辑，不妨直接复制本文附带的脚本与配置，一键跑起 uvx mcp-server-time。至此，复杂的时区计算从难以维护的代码，变成了聊天窗口里的自然对话——这正是 MCP 生态带给开发者的“魔术时刻”。

---

参考资料

1. Model Context Protocol time 服务器 README (github.com)

2. mcp-server-time 原始文档（raw README） (raw.githubusercontent.com)

3. Time MCP Server 官方站点 (mcp.so)

4. Open WebUI 对 MCP 支持文档 (docs.openwebui.com)

5. Astral uv 官方指南：tool 与 uvx 讲解 (docs.astral.sh, docs.astral.sh)

6. 六尺博客对 uvx 隔离环境特性的评测 (sixfeetup.com)

7. uv GitHub README：工具运行示例 (github.com)

8. Trae IDE 官方 MCP 介绍页 (docs.trae.ai)

9. AIbase 对 Trae 1.3.0 更新的技术拆解 (aibase.com)

10. JetBrains AI Assistant MCP 配置指南 (jetbrains.com)