10 分钟用 TaoToken 跑通 Cherry Studio 的 Filesystem MCP
2026/9/19 21:24:01 网站建设 项目流程

🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度

1. 目标与产物:在 Cherry Studio 里让模型真正读到本地目录

这篇内容面向一个很具体的任务:在 Cherry Studio 中接入 TaoToken 作为兼容供应商,加载 Filesystem MCP(mcp-server-filesystem),然后让模型读取一个本地目录并完成一次文件统计。最终交付三样东西:一份可直接粘贴的 MCP JSON 片段、一段可复用的调用 prompt、以及一次文件读写的完整日志。TaoToken 在这里承担两个角色:一是提供 API Key,二是作为默认供应商的 Base URL 来源。开始前先到官网创建 Key,地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate&utm_content= ,注册后在控制台生成 Key 即可。Cherry Studio 本身是桌面端 MCP 客户端,支持自定义 OpenAI 兼容供应商,也支持通过 JSON 配置 MCP Server,所以整条链路不需要额外写胶水代码。Filesystem MCP 是官方参考实现之一,能力边界清晰:列目录、读文件、写文件、搜索、获取元信息。把它挂到 Cherry Studio 后,模型就能通过工具调用访问你授权的目录。本文不包含任何排行分数,也不对模型能力做评测排名,只记录一次可复现的接入与调用过程。

2. 操作步骤:拿 Key、装 MCP、配 Cherry Studio

第一步是拿 Key。访问 https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate&utm_content= ,登录后进入控制台,在 API Keys 页面创建一个新 Key。建议按用途命名,例如cherry-fs-mcp,方便后续轮换。Key 只在创建时完整显示一次,复制后先存到本地密码管理器。TaoToken 的 API 入口是 https://taotoken.net/api ,这个地址在下一步配置供应商时会用到。注意 API 地址不带 UTM 参数,保持干净。

第二步是准备 Filesystem MCP。它是 Node 生态的包,通常通过npx拉起。先确认本机 Node 版本满足要求,然后可以直接用命令行验证一次:

node -v npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Documents/demo

如果这条命令能启动并停在等待输入的状态,说明 MCP Server 本身可用。按 Ctrl+C 退出即可。这里授权的目录是/Users/yourname/Documents/demo,你可以换成自己的目标目录。注意:Filesystem MCP 只会访问你显式传入的目录,不会越界。

第三步是在 Cherry Studio 中写入 TaoToken 兼容供应商。打开设置,找到模型服务或供应商管理,新增一个 OpenAI 兼容类型的供应商。名称填TaoToken,Base URL 填https://taotoken.net/api,API Key 填刚才创建的那把。保存后,在模型列表里填入你要使用的模型 ID。模型 ID 以官网文档和控制台展示为准,不同时期可用模型会变化,不要照搬旧文章里的字符串。配置完成后点一次测试连接,确认返回正常。

第四步是配置 MCP。Cherry Studio 的 MCP 配置通常是一个 JSON 文件或设置面板里的 JSON 编辑区。写入下面的片段:

{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/Documents/demo" ] } } }

保存后重启 Cherry Studio 或点击重新加载 MCP。如果面板里出现filesystem且状态为已连接,说明挂载成功。此时在对话界面选择刚才配置的 TaoToken 供应商和模型,就可以开始调用工具了。

3. TaoToken 接入与配置要点

TaoToken 在整条链路里出现在两个位置:拿 Key 和默认供应商。拿 Key 的入口是控制台,供应商配置的 Base URL 是https://taotoken.net/api。如果你同时使用 Claude Code,配置方式不同:需要在settings.json里写ANTHROPIC_BASE_URLANTHROPIC_API_KEY等环境变量;如果使用 Codex,则改config.toml。Cherry Studio 属于图形化 MCP 客户端,走的是 OpenAI 兼容供应商路径,所以只需要 Base URL 和 Key。若你使用 CC Switch 这类多配置切换工具,通常涉及三件套:供应商配置、Key 管理、模型映射,切换时确认 Base URL 没有被旧配置覆盖。接入文档和 API Keys 页面可以从官网进入,遇到 401 先检查 Key 是否带空格,遇到 404 先确认 Base URL 是否误加了路径后缀。TaoToken 的 API 地址保持https://taotoken.net/api即可,不要自行拼接/v1之外的路径,除非文档明确说明。

4. 可验证结果与失败分支

配置完成后,用一段 prompt 触发文件统计。示例:

请使用 filesystem 工具,列出 /Users/yourname/Documents/demo 下的所有文件, 统计文件总数、总大小,并按扩展名分组给出数量。最后把统计结果写入 该目录下的 report.md。

一次完整的调用日志大致如下(节选):

[工具调用] filesystem.list_directory 参数: { "path": "/Users/yourname/Documents/demo" } 返回: a.txt, b.md, c.png, sub/d.log [工具调用] filesystem.get_file_info 参数: { "path": "/Users/yourname/Documents/demo/a.txt" } 返回: size=1024, isDirectory=false [工具调用] filesystem.write_file 参数: { "path": "/Users/yourname/Documents/demo/report.md", "content": "..." } 返回: success

如果模型没有触发工具调用,先确认对话界面是否选中了带工具能力的模型,再确认 MCP 状态是否为已连接。如果工具调用返回权限错误,检查 JSON 里的目录路径是否为绝对路径、是否存在、是否有读写权限。如果供应商返回鉴权失败,回到控制台确认 Key 状态,并检查 Base URL 是否被误改为其他地址。失败分支里最常见的是路径写成了相对路径,Filesystem MCP 对相对路径的处理依赖启动目录,建议一律使用绝对路径。

5. 限制、成本与模型选择

Filesystem MCP 的能力限于你授权的目录,不会自动索引整个磁盘。写入操作会真实修改文件,建议先在测试目录验证。成本方面,TaoToken 的计费以官网和控制台展示为准,不同模型的单价不同,长上下文和工具调用会消耗更多 token。模型选择上,优先选支持工具调用的模型,否则 MCP 无法生效。本文不含排行分数,也不对任何模型做跑分对比;如果你需要看公开榜单,请以榜单页面标注的日期和来源为准,并注意榜单分数与 TaoToken 售价无关。更多模型 ID 和可用性请以官网文档为准:https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate&utm_content= 。接入排障和插件配置可参考 API Keys 与接入文档页面。整条链路的核心就是:拿 Key、配 Base URL、挂 MCP、发 prompt、看日志。跑通一次之后,你可以把目录换成自己的项目目录,让模型做文件清点、批量重命名前的统计,或者生成目录结构说明。

🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询