1. 为什么我要把 Cherry Studio、硅基流动和 ModelScope 拼在一起Cherry Studio 是一款开源的全能 AI 客户端支持 Windows、macOS、Linux把多模型对话、知识库、AI 绘画、翻译塞进同一个界面。硅基流动提供兼容 OpenAI 协议的大模型 API9B 及以下模型有永久免费额度适合个人开发者。ModelScope魔塔社区的 MCP 服务器市场则提供标准化工具扩展让助手能调用文档处理、数据查询等外部能力。这三者组合起来能做什么简单说Cherry Studio 当壳硅基流动当大脑ModelScope MCP 当手脚。适合谁想零成本拥有一个可本地运行、能挂工具、能换模型的个人 AI 助手又不想折腾服务器的人。我实测下来整条链路从装客户端到跑通 MCP 工具调用半小时内能完成。这篇会给出 settings.json 与 config.toml 骨架、统一 Key/API 通道配置示例并演示 MCP 工具挂载与对话验证步骤。技术部分占大头跟着敲就能复现。2. 前置准备TaoToken 统一通道与三件套安装2.1 为什么先配一个统一 API 通道Cherry Studio 支持多服务商但每接一家就要填一次 Key、改一次 Base URL模型多了很乱。我的做法是先建一个统一通道把硅基流动、ModelScope 等来源的模型都挂到同一个入口下后面加模型只改一处配置。TaoToken 提供的就是这种统一入口兼容 OpenAI 协议Cherry Studio 里选OpenAI类型即可对接。官网地址 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API 根地址 https://taotoken.net/api 不加 UTM。注意这里只是把它当作一个 OpenAI 兼容的 API 通道来用配置方式和接任何 OpenAI 兼容服务一致。2.2 拿 Key 与装客户端先去控制台创建 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。Key 只显示一次复制到本地密码管理器。然后装 Cherry Studio从官网下载对应系统安装包。装完先别急着加模型把配置文件目录找出来Windows 在%APPDATA%\CherryStudiomacOS 在~/Library/Application Support/CherryStudioLinux 在~/.config/CherryStudio。后面 settings.json 就放这里。硅基流动和 ModelScope 的账号也顺手注册好硅基流动在控制台拿 API KeyModelScope 在 MCP 市场里挑服务器。这两家的 Key 后面会作为独立 provider 填进 Cherry Studio也可以统一走 TaoToken 通道看你习惯。3. 可复制配置settings.json 与 config.toml 骨架3.1 settings.json 骨架Cherry Studio 的服务商配置存在 settings.json 里。下面是我用的骨架把apiKey换成你自己的baseUrl指向统一通道{ providers: [ { id: taotoken, name: TaoToken 统一通道, type: openai, apiKey: sk-你的Key, baseUrl: https://taotoken.net/api, models: [ { id: Qwen/Qwen2.5-7B-Instruct, name: Qwen2.5-7B }, { id: deepseek-ai/DeepSeek-V3, name: DeepSeek-V3 } ] }, { id: siliconflow, name: 硅基流动, type: openai, apiKey: sk-硅基流动Key, baseUrl: https://api.siliconflow.cn/v1, models: [ { id: Qwen/Qwen2.5-7B-Instruct, name: Qwen2.5-7B 免费 } ] } ], defaultModel: Qwen/Qwen2.5-7B-Instruct }字段说明type固定openai因为两家都兼容 OpenAI 协议baseUrl硅基流动是https://api.siliconflow.cn/v1TaoToken 是https://taotoken.net/apimodels数组里id必须和服务商文档一致写错会报 404。3.2 config.toml 骨架MCP 服务器MCP 服务器配置用 config.toml放在同一目录。下面挂一个 ModelScope 上的文档处理 MCP[[mcpServers]] name modelscope-doc command npx args [-y, modelscope/mcp-doc-server] env { MODELSCOPE_API_KEY 你的ModelScope Key } [[mcpServers]] name modelscope-search command npx args [-y, modelscope/mcp-search-server] env { MODELSCOPE_API_KEY 你的ModelScope Key }command和args按 ModelScope MCP 市场里每个服务器给的启动命令填env里放对应 Key。改完重启 Cherry Studio 生效。提示MCP 服务器是独立进程Cherry Studio 通过 stdio 和它通信。如果启动失败先在终端手动跑一遍npx命令看报错。4. 验证请求从对话到 MCP 工具调用4.1 基础对话验证重启后新建对话模型选Qwen/Qwen2.5-7B-Instruct发一句用一句话解释 MCP 协议。正常返回说明统一通道通了。如果报 401检查 Key报 404检查baseUrl和模型id。再用 curl 直接打一次接口排除客户端问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: Qwen/Qwen2.5-7B-Instruct, messages: [{role: user, content: 你好}] }返回 JSON 里有choices[0].message.content就说明通道没问题。4.2 MCP 工具挂载验证在 Cherry Studio 设置里找到 MCP 面板应该能看到 config.toml 里配的两个服务器状态显示已连接。新建对话时勾选modelscope-doc工具然后发帮我总结这段文字……。观察返回里有没有工具调用标记比如tool_call字段。如果工具没被调用检查三点模型是否支持 function callingQwen2.5 系列支持、MCP 服务器是否真的连上、工具描述是否被正确加载。我踩过的坑是npx首次运行要下载包超时导致连接失败手动跑一次预热就好。5. 本篇常见错排查报错一Error: connect ECONNREFUSEDMCP 服务器没起来。在终端手动执行 config.toml 里的command args看是包没装还是 Key 没填。ModelScope 的 MCP 服务器大多需要MODELSCOPE_API_KEY漏填会直接退出。报错二401 UnauthorizedKey 错了或过期。TaoToken 的 Key 在控制台重新生成硅基流动的 Key 在它自己的控制台。注意别把两家的 Key 填串了。报错三404 model not found模型id写错。硅基流动的模型 id 形如Qwen/Qwen2.5-7B-Instruct大小写和斜杠都要对。去服务商文档复制别手打。报错四MCP 工具列表为空config.toml 格式错了。TOML 对缩进和引号敏感env必须写成{ KEY value }一行。改完用在线 TOML 校验器过一遍。报错五对话卡住不返回大概率是模型不支持流式或超时。在 Cherry Studio 里关掉流式输出试试或者换个小模型先验证链路。6. 后续怎么扩展与统一管理链路跑通后加模型只需在 settings.json 的models数组里加一行重启即可。加 MCP 工具同理在 config.toml 里追加一个[[mcpServers]]块。所有 Key 建议集中放一个密码管理器配置文件里只留占位符避免误提交到 Git。长期做编码或 Agent 场景的话可以考虑 Coding Plan入口 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 配合 Cherry Studio 的代码补全和 MCP 工具能覆盖大部分日常开发辅助。模型对话验证入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Claude Code 相关配置参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后说个实用技巧把 settings.json 和 config.toml 备份到私有仓库换机器时直接覆盖省去重新配置的麻烦。MCP 服务器的npx包版本建议锁死避免自动升级后接口变动导致工具失效。