企业官网建设流程全解析

1. 为什么要在 Cherry Studio 里加一个 time MCP 服务器

如果你正在用 Cherry Studio 做本地 AI 工具链的日常主力，大概率会遇到一个很具体的尴尬：模型聊到"现在几点""今天几号""帮我算下距离某个日期还有多少天"时，回答要么含糊，要么直接编一个时间。大模型本身没有实时时钟，它只能靠训练数据里的时间感去猜，猜错是常态。

MCP（Model Context Protocol）就是来解决这类"模型缺一只手"的问题的。它把外部能力包装成标准工具，让 Cherry Studio 里的模型可以主动调用。time 这个 MCP 服务器是最适合拿来练手的第一个：逻辑简单、依赖少、验证直观，配好之后你问一句"现在上海几点"，模型能真的去调工具拿时间，而不是瞎编。

这篇聚焦一件事：在 Cherry Studio 里通过 uvx 方式添加 time MCP 服务器，从装 uv、写配置、到验证工具真的可用，一条龙走完。适合已经在用 Cherry Studio、想开始接 MCP 但被 JSON 配置和 uvx 报错卡住的人。我试过把这套流程在 Windows 和 macOS 上各跑一遍，坑基本集中在 uvx 路径和时区参数上，下面会逐个拆开。

核心检索词先摆清楚：Cherry Studio 是什么——一个支持多模型、支持 MCP 的本地 AI 客户端；MCP 服务器是什么——给模型挂载外部工具的服务进程；uvx 是什么——uv 工具链里用来直接运行 Python 包命令的执行器，不用你手动 pip install。理解这三个词，后面的配置就是填空题。

2. 前置准备：uv 与 uvx 到底装在哪

很多人卡在第一步不是因为不会配，而是因为 uvx 根本没进 PATH。uvx 不是独立安装的软件，它是 uv 自带的命令。所以你只需要装 uv，uvx 就跟着来了。

Windows 上用官方脚本装（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS / Linux 上用：

curl -LsSf https://astral.sh/uv/install.sh | sh

装完之后有一个高频坑：当前终端不会自动刷新 PATH。你必须关掉终端重开，或者手动 source 一下配置文件。验证命令就一条：

uv --version uvx --version

两条都能打印版本号，才算真的装好。如果uv --version有输出但uvx --version报 command not found，说明你的 uv 版本太老，升级一下：

uv self update

这里要提醒一句：即使你之前"好像装过 uv"，也建议按上面的方式重装或升级一遍。旧版本 uv 里 uvx 的行为和新版有差异，尤其是包缓存和 PATH 注入逻辑，重装能省掉后面一堆玄学报错。

装好之后先别急着开 Cherry Studio，在终端里直接跑一次 time 服务器，确认这个包本身能拉起来：

uvx mcp-server-time --local-timezone=Asia/Shanghai

第一次运行会下载依赖，稍等几秒。如果它停在等待输入的状态（没有报错退出），说明包能正常启动，Ctrl+C 结束即可。这一步能提前把"网络拉包失败""包名写错"这类问题和 Cherry Studio 的配置问题分开。

3. 可复制的 Cherry Studio MCP 配置骨架

打开 Cherry Studio，左下角齿轮图标进设置，找到 MCP 服务器，点添加。弹出的配置框里填 JSON。time 服务器的最小可用配置如下：

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

逐字段说明一下，方便你按自己环境改：

时区参数是重点。Asia/Shanghai对应东八区，如果你在别的时区，要换成对应的 IANA 时区名，比如America/New_York、Europe/London、Asia/Tokyo。写错了不会导致服务器起不来，但返回的时间会偏，验证时容易误判成"工具没生效"。

注意：JSON 里不能有注释，不能有多余逗号，引号必须是英文半角。中文引号是最高频的隐形杀手，肉眼几乎看不出来，建议直接复制上面的骨架再改。

如果你在 Windows 上遇到 uvx 找不到的情况，把 command 换成完整路径。先查路径：

where uvx

输出类似C:\Users\你的用户名\.local\bin\uvx.exe，然后配置改成：

{ "mcpServers": { "Time": { "command": "C:\\Users\\你的用户名\\.local\\bin\\uvx.exe", "args": [ "mcp-server-time", "--local-timezone=Asia/Shanghai" ] } } }

注意 JSON 里反斜杠要写成双反斜杠\\，这是 Windows 路径在 JSON 中的转义要求，单反斜杠会被解析成非法转义字符，直接导致配置解析失败。

4. 启动后验证 time 工具是否真的可用

配置保存后，回到 MCP 服务器列表，Time 这一项的状态应该显示为已连接（通常是一个绿色对勾）。如果显示红色或一直转圈，先别怀疑配置内容，往下看第 5 节的排查。

状态绿了不代表工具真的能被模型调用，还要做一次端到端验证。在 Cherry Studio 里新建一个对话，选一个支持工具调用的模型，然后直接问：

现在上海几点？请调用 time 工具获取，不要凭记忆回答。

观察两个点：一是回复里是否出现了工具调用的痕迹（很多客户端会显示"正在调用 Time"之类的提示）；二是返回的时间是否和你系统时间一致。如果模型直接给了一个时间但没有任何工具调用记录，说明它没走 MCP，可能是模型不支持 function calling，或者这个对话没挂上 MCP 服务器。

再补一个更严格的验证，问一个需要计算的问题：

用 time 工具查一下当前时间，然后告诉我距离今天结束还有多少小时。

这个问题的好处是：模型必须真的拿到当前时间才能算，编不出来。如果它能给出合理的小时数，说明 time 工具返回的数据被正确消费了。

实测下来，time 服务器通常提供两个工具：获取当前时间、时间格式转换。你可以在对话里让模型列出它当前可用的工具，确认 time 相关的工具确实在列表里。这一步能排除"服务器连上了但工具没注册"的中间态。

5. 本篇常见报错逐个排查

5.1 uvx: command not found

这是出现频率最高的一个。原因无非三种：uv 没装、装了但没重启终端、装了但 PATH 没生效。按顺序排查：

uv --version

没输出就是没装或 PATH 问题。重开终端再试。还不行就手动把 uv 的 bin 目录加进 PATH。Windows 默认在%USERPROFILE%\.local\bin，macOS/Linux 在~/.local/bin。加完 PATH 后，Cherry Studio 也要完全退出重启，因为它启动时继承的是启动那一刻的环境变量，不重启读不到新 PATH。

5.2 Cherry Studio 提示连接失败

先怀疑 JSON 格式。把配置贴到任意 JSON 校验工具里过一遍，重点看逗号、引号、花括号。中文引号、末尾多余逗号、少一个右花括号，都会让整个配置解析失败。

格式没问题就换完整路径，方法见第 3 节。Windows 上 uvx 的 PATH 注入经常对 GUI 程序不生效，用绝对路径是最稳的解法。

还有一种情况是包名写错。正确包名是mcp-server-time，不是mcp_time也不是time-mcp。名字错了 uvx 会去 PyPI 找不存在的包，报错信息可能被 Cherry Studio 吞掉，只显示连接失败。

5.3 时间不对或时区偏移

检查--local-timezone的值。必须是合法的 IANA 时区名，Asia/Shanghai这种格式。写成GMT+8或UTC+8不一定被识别。改完保存，重启 MCP 服务器（在列表里关掉再开，或重启 Cherry Studio）。

5.4 状态绿了但模型不调用工具

这通常不是 MCP 的问题，而是模型或对话设置的问题。确认你选的模型支持工具调用；确认这个对话没有关闭工具功能；有些客户端需要在新对话里才会加载最新的 MCP 工具列表，老对话可能缓存了旧的工具集，新建一个对话再试。

5.5 首次启动特别慢

第一次 uvx 运行要下载包和依赖，慢是正常的。如果一直卡住，检查网络能否访问 PyPI。可以先在终端里手动跑一次uvx mcp-server-time --local-timezone=Asia/Shanghai，把包缓存下来，之后 Cherry Studio 启动就快了。

6. 把 time 跑通之后，下一步接什么

time 这个服务器的价值不在于它本身多强，而在于它是一条最短的验证路径：装 uv、写 JSON、看状态、发请求、拿结果，整条链路跑通一次，后面加任何 MCP 服务器都是同一套动作换参数。

如果你打算把 MCP 用在长期编码或 Agent 场景，比如让模型读写文件、查文档、跑命令，那配置会更多、调试更频繁，可以考虑用 Coding Plan 这类面向持续开发场景的方案来管理额度和调用：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=cherry_studio_mcp_time

配置过程中如果卡在 API Key 或接入参数上，直接去 API Keys 页面拿：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=cherry_studio_mcp_time

想先不折腾本地配置、直接验证模型调用工具的效果，可以用模型对话页面试：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=cherry_studio_mcp_time

接入细节和参数说明都在文档里：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=cherry_studio_mcp_time

最后留一个我踩过的坑：改完配置后，Cherry Studio 的 MCP 服务器列表有时不会自动刷新状态，需要手动关掉再打开，或者干脆重启客户端。别看到红点就急着改 JSON，先重启一次，能省掉一半的无效排查。