企业官网建设流程全解析

1. 为什么要在 CherryStudio 里接一个本地 FileSystem MCP 服务器

CherryStudio 本身是个多模型聚合客户端，能聊天、能挂知识库，但它默认碰不到你硬盘上的文件。你让它读一个本地 txt，它只能让你手动粘贴内容；你让它改一段配置，它只能把改好的文本吐给你，落盘还得自己动手。MCP（Model Context Protocol）就是来解决这个断层的——它给模型装上一套标准化的“手”，让模型能通过工具调用去操作外部资源，而 FileSystem 这个 MCP 服务器，管的就是本地文件系统的读写。

FileSystem MCP 服务器能做什么？简单说，它把指定目录下的文件操作封装成一组工具：读文件、写文件、编辑文件、创建目录、列目录、移动文件、搜索文件、获取文件属性。你把它挂到 CherryStudio 上，再选一个支持函数调用的模型，就能在聊天框里用自然语言指挥模型去操作你授权的那个目录。适合谁？适合需要让 AI 帮忙批量整理笔记、读取本地代码片段、生成配置文件并直接落盘的开发者，也适合想把本地文档喂给模型做分析、又不想手动复制粘贴的人。

我试过把项目里的日志目录挂上去，让模型自己读日志、定位报错、把分析结果写成 markdown 存回同目录，整个链路跑通之后确实省事。但这里有个前提：你得先把 MCP 服务器配好，把目录权限划清楚，否则模型要么读不到文件，要么在你没注意的时候写错地方。这篇就按 CherryStudio 的实际配置路径，从装依赖、加服务器、写配置、验证读写，到常见报错排查，一步步走完。核心检索词就三个：CherryStudio、MCP 服务器、FileSystem 本地文件系统读写。

需要先说明一点：CherryStudio 里挂的 FileSystem MCP 服务器，操作范围完全由你在配置里指定的目录决定，它不会也不能越出那个目录去碰系统其他位置。这一点在后面的权限设置里会反复强调，因为这是安全底线。

2. 前置准备：UV、Bun 与 TaoToken 接入配置

FileSystem MCP 服务器的运行依赖两个工具：UV 和 Bun。UV 是 Python 包管理器的替代品，Bun 是 JavaScript 运行时，MCP 服务器进程需要它们来拉起。CherryStudio 在 MCP 服务器页面提供了一个“安装”按钮，理论上点一下就能自动下载。但实测下来，这个自动安装经常不靠谱——就算界面显示安装成功，你去C:\Users\<用户名>\.cherrystudio\bin（Windows）或~/.cherrystudio/bin（macOS/Linux）下面看，文件夹里空空如也。这就是典型的“谎报成功”。

所以稳妥做法是手工安装。你需要把 UV 和 Bun 的可执行文件下载下来，放进上面那个 bin 目录。Windows 下是uv.exe和bun.exe，macOS/Linux 下是对应的二进制文件。放好之后，在终端里执行uv --version和bun --version，能打印出版本号才算真正就绪。如果提示找不到命令，说明目录没进 PATH，或者文件没放对位置。

接下来是模型接入这一环。CherryStudio 要调用支持函数调用的模型，才能驱动 MCP 工具。你可以用 TaoToken 提供的 API 来接入，它兼容 OpenAI 风格的接口，配置起来比较直接。TaoToken 的 API 地址是https://taotoken.net/api，你需要在控制台生成一个 API Key，然后在 CherryStudio 的模型设置里填上 Base URL 和 Key。

具体操作路径：打开 CherryStudio，进入设置里的模型服务，添加一个自定义 OpenAI 兼容 provider。Base URL 填https://taotoken.net/api，API Key 填你在控制台生成的 Key。模型 ID 填你计划使用的、支持 function calling 的模型名称。保存之后，在聊天界面选这个模型，模型名称旁边应该会出现一个扳手图标，那就代表它支持工具调用。

这里有个细节：MCP 服务器配置和模型接入是两条线，但必须都通。MCP 服务器负责提供工具，模型负责决定什么时候调用工具。如果模型不支持函数调用，就算 MCP 服务器挂上了，聊天框里也不会触发文件操作。所以选模型时一定要确认它支持 tool use。

TaoToken 的 API Key 在控制台的 API Keys 页面生成，生成后复制保存，填到 CherryStudio 里即可。如果你还没生成，可以先访问https://taotoken.net/api-keys去创建一个。接入文档在https://taotoken.net/doc，里面有更详细的参数说明。整个前置准备做完，你手里应该有三样东西：装好的 UV 和 Bun、一个可用的 API Key、一个支持函数调用的模型配置。

3. 可复制配置：FileSystem MCP 服务器 JSON 片段与目录权限

这一节是核心，配置写不对，后面全白搭。CherryStudio 的 MCP 服务器配置界面里，添加服务器时可以选择“搜索 MCP”在线添加，也可以手动填配置。我建议手动填，因为在线搜索添加的服务器，参数往往需要你再改一遍，不如直接写清楚。

先说你最终要得到的配置结构。CherryStudio 的 MCP 服务器配置本质上是一段 JSON，描述用哪个命令启动服务器、传什么参数、设什么环境变量。FileSystem MCP 服务器的标准启动方式是通过npx或bunx拉起@modelcontextprotocol/server-filesystem这个包，然后把你要授权的目录作为参数传进去。

下面是一段可复制的配置片段，你可以直接粘到 CherryStudio 的 MCP 服务器配置里：

{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "D:\\mcp_on_t11pro" ] } } }

这段配置的意思是：用npx启动@modelcontextprotocol/server-filesystem，并把D:\mcp_on_t11pro这个目录授权给它。服务器启动后，所有文件操作都被限制在这个目录及其子目录内。你想换目录，就改args数组最后那一项。

如果你用的是 Bun，可以把command改成bunx，效果一样。Windows 下路径写法注意一下：从 CherryStudio v1.2.4 起，单反斜杠\已经不需要替换成双反斜杠\\了，你按正常路径写就行。但如果你是在纯 JSON 文件里手写，反斜杠本身是转义字符，所以D:\mcp_on_t11pro在 JSON 字符串里要写成D:\\mcp_on_t11pro，这是 JSON 语法要求，不是 CherryStudio 的要求。在 CherryStudio 界面里填参数时，直接写D:\mcp_on_t11pro即可。

如果你要授权多个目录，就在args里继续追加路径：

{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "D:\\mcp_on_t11pro", "D:\\notes" ] } } }

这样两个目录都会被授权，服务器对这两个目录下的文件都有操作权限。

目录权限这块要特别说清楚。FileSystem MCP 服务器提供的工具包括：读文件、写文件、编辑文件、创建目录、读取并列出目录、移动文件、搜索文件、获取文件属性。注意，它没有删除权限。这是官方刻意去掉的，怕模型误删用户文件造成不可逆的数据丢失。所以你在配置时不用担心模型会把你目录里的东西删掉，它做不到。但写和编辑权限是有的，模型可以创建新文件、修改已有文件内容，所以授权目录里如果有重要文件，建议先备份，或者单独划一个工作目录出来给 MCP 用。

另外，服务器进程是以你当前用户的身份运行的，所以它能访问的权限范围，就是你当前用户对该目录的权限范围。如果你把目录设成只读，那模型也写不进去。这一点在排查“为什么写文件失败”时会用到。

配置保存后，重启 CherryStudio 让配置生效。然后在聊天界面输入框下方找到“MCP 服务器”按钮，勾选你刚添加的 filesystem 服务。再确认当前选的模型旁边有扳手图标，说明工具调用已就绪。

4. 验证请求：一次完整的文件创建、读取、修改、删除操作

配置挂上之后，别急着让它干复杂活，先跑一遍完整的读写链路，确认每一步都通。下面我按创建、读取、修改、删除四个动作走一遍，你可以跟着操作。

第一步，创建文件。在 CherryStudio 聊天框里输入：

使用 filesystem 工具，在 D:\mcp_on_t11pro 目录下创建一个名为 test_mcp.txt 的文件，内容写入：hello mcp filesystem

模型收到指令后，会调用 FileSystem MCP 的写文件工具。如果成功，你会看到工具调用返回类似“文件已创建”的结果。这时候你去D:\mcp_on_t11pro目录下看，应该能看到test_mcp.txt，打开确认内容正确。

第二步，读取文件。继续输入：

使用 filesystem 工具，读取 D:\mcp_on_t11pro\test_mcp.txt 的内容并显示

模型会调用读文件工具，把内容返回并显示在聊天框里。你应该看到hello mcp filesystem。这一步验证的是读权限和路径解析是否正常。

第三步，修改文件。输入：

使用 filesystem 工具，把 D:\mcp_on_t11pro\test_mcp.txt 的内容修改为：hello mcp filesystem updated

模型会调用编辑工具，替换文件内容。完成后你再读一次，确认内容变成hello mcp filesystem updated。这一步验证的是编辑权限。

第四步，删除文件。这里要注意，FileSystem MCP 服务器没有删除工具，所以你不能直接让它删。但你可以用移动工具把文件移到另一个位置，或者用写文件工具覆盖内容。如果你确实想删，得手动去目录里删，或者用系统命令。我建议在测试阶段就保留这个文件，别删，方便后面排查问题时对照。

如果你想让模型列出目录内容，可以输入：

使用 filesystem 工具，列出 D:\mcp_on_t11pro 目录下的所有文件和子目录

模型会返回目录列表。这个动作验证的是目录读取和列出权限。

整套跑下来，如果创建、读取、修改、列目录都成功，说明本地文件系统读写链路已经通了。这时候你可以开始让它做实际任务，比如读一个日志文件、分析内容、把结果写成报告存回目录。

再补充一个验证点：搜索文件。输入：

使用 filesystem 工具，在 D:\mcp_on_t11pro 目录下搜索所有包含 test 的文件

模型会调用搜索工具，返回匹配的文件列表。这个功能在目录文件多的时候很有用。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth

配置过程中最容易卡住的几个报错，我按实际遇到的顺序列一下，每个都给排查方向。

第一个，401 Unauthorized。这个通常出现在模型调用环节，不是 MCP 服务器本身的问题。原因一般是 API Key 填错、过期，或者 Base URL 写错。检查 CherryStudio 里模型服务的 Base URL 是不是https://taotoken.net/api，Key 是不是从控制台复制完整了。如果 Key 没问题，再看模型 ID 是否拼写正确。401 的本质是鉴权失败，跟 MCP 配置无关，但因为它会导致模型无法响应，你会以为是 MCP 挂了。

第二个，local proxy failed。这个报错说明 CherryStudio 在尝试连接本地 MCP 服务器进程时失败了。可能原因有几个：UV 或 Bun 没装好，npx或bunx命令找不到；MCP 服务器包没下载成功；或者配置里的命令路径不对。排查方法：先在系统终端里手动执行npx -y @modelcontextprotocol/server-filesystem D:\mcp_on_t11pro，看能不能正常启动。如果终端里也报错，那就是环境问题，跟 CherryStudio 无关。如果终端里能启动，但 CherryStudio 里报 local proxy failed，那就是 CherryStudio 的 MCP 进程管理出了问题，重启客户端试试。

第三个，reading choices 相关报错。这个通常出现在模型返回结果解析阶段，提示读取 choices 字段失败。原因可能是模型返回格式不符合预期，或者 API 返回了错误信息但被当成正常响应解析了。排查时先看 CherryStudio 的日志，确认 API 实际返回了什么。如果是模型不支持函数调用，返回里就不会有 tool_calls 字段，MCP 工具自然也不会被触发。确认你选的模型支持 function calling。

第四个，OAuth 相关报错。FileSystem MCP 服务器本身不需要 OAuth，但如果你在 CherryStudio 里配了其他需要 OAuth 的 MCP 服务器，或者模型服务端要求 OAuth 流程，就可能碰到。排查方向是确认当前 MCP 服务器是否需要额外认证。FileSystem 是本地进程，不走网络认证，所以如果你看到 OAuth 报错，大概率是模型服务那边的配置问题，检查 API Key 的认证方式是否选对。

还有一个容易忽略的点：路径权限。如果模型调用写文件工具时返回“permission denied”或类似错误，检查你授权的目录是否存在、当前用户是否有写权限。Windows 下如果目录在系统保护区域，比如C:\Program Files下面，普通用户是写不进去的。把工作目录设在用户目录下，比如D:\mcp_on_t11pro或C:\Users\<用户名>\mcp_workspace，就没这个问题。

如果 MCP 服务器配置里同时用了 Cline MCP 或 Codex 的 auth.json 方式，记得三件套要写全：Base URL、Key、Model ID。缺一个都可能导致调用链断掉。CC Switch 这类工具切换配置时，也要确认切换后的配置里这三项都正确。

6. 长期使用建议与接入入口

链路跑通之后，日常使用有几个习惯可以帮你少踩坑。第一，给 MCP 单独划一个工作目录，别把整个项目根目录或者用户主目录授权进去。工作目录里放需要模型处理的文件，处理完再手动归档。第二，定期检查授权目录里的文件变化，虽然 FileSystem MCP 没有删除权限，但写和编辑是有的，模型可能覆盖你不希望改的文件。第三，模型选择上，优先用函数调用能力稳定的模型，避免出现工具调用半途失败的情况。

如果你还没配好模型接入，可以先到 TaoToken 控制台生成 API Key，然后按接入文档把 Base URL 和 Key 填到 CherryStudio 里。模型对话入口可以用来快速验证模型是否正常响应，确认没问题后再挂 MCP 服务器。对于需要长期跑编码任务或 Agent 流程的场景，Coding Plan 会更合适，它针对持续调用做了优化。

接入文档在https://taotoken.net/doc，API Key 管理在https://taotoken.net/api-keys，模型对话在https://taotoken.net/chat，Coding Plan 在https://taotoken.net/coding-plan。配置过程中如果碰到 MCP 服务器启动失败，先回终端手动跑一遍启动命令，确认环境没问题，再回 CherryStudio 排查客户端侧的原因。这套流程走顺之后，让模型直接读写本地文件就是日常操作了。