ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Cherry Studio、Trae 加 uv MCP:DeepSeek 通道改到 TaoToken

2026/9/18 21:29:35 拓冰建站 浏览量
Cherry Studio、Trae 加 uv MCP:DeepSeek 通道改到 TaoToken Cherry Studio、Trae 加 uv MCPDeepSeek 通道改到 TaoTokenCherry Studio、Trae 里加 uv MCP 时最容易卡住的不是 uv init demo也不是 main.py 里那套 SQLite 工具而是模型通道MCP 服务已经起来工具列表也看得见智能体却不去调 create_table。这篇承接 uv 创建 SQLite MCP 的流程只改一件事把 DeepSeek 的 API 通道换成 TaoToken官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Base URL 用 https://taotoken.net/api。uv、main.py、--db-path、Cherry Studio 的 MCP 参数、Trae 的 mcpServers 都照原步骤来TaoToken 只负责提供 Key 和模型入口不参与 uv 安装、SQLite MCP 启动也不参与具体 SQL 的执行。先把边界划清楚后面配置会顺很多。SQLite MCP 负责“能不能操作数据库”TaoToken 负责“模型能不能被 Cherry Studio 和 Trae 调到”。两件事分开排查出问题时就不会在 uv 和 API 之间来回猜。一、场景uv init demo 与 main.py 都跑通了卡在模型通道常规流程是这样用 uv 建项目、加依赖、写 main.py然后在 Cherry Studio 里加一个 MCP 服务最后在 Trae 的 mcpServers 里加 sqlite-server。命令大致是uv init demo cd demo uv add mcp[cli]main.py 沿用原文那份 SQLite MCP 实现对外暴露 read_query、write_query、create_table、list_tables、describe_table、append_insight 这几个工具启动时通过 --db-path 指定数据库文件。MCP 服务本身是 stdio 形式不是 HTTP 服务所以 Cherry Studio 和 Trae 里配的都是“命令 参数”而不是 URL。问题通常出在下一步原文写的是“申请 DeepSeek API、配置 DeepSeek API”很多人到这里会去 DeepSeek 官网开 Key然后把 Base URL 填成平台地址。结果 Cherry Studio 的 MCP 面板显示已连接Trae 的 MCP 面板也没报红但你在对话框里说“帮我建一张 demo 表”智能体只回一段文字根本不去调用 create_table。原因不是 MCP 没起而是模型通道没接对Agent 拿不到稳定的 tool call 能力。本文要做的就是把这个通道改到 TaoTokenCherry Studio 的模型供应商配 TaoToken 的 Base URL 和 KeyTrae 里调用 DeepSeek 的模型通道也用同一套。MCP 服务和 --db-path 完全不动配通后 Trae 智能体才能继续按原文步骤查 demo 表结构、插入 2 条测试数据并查回结果。二、TaoToken 前置拿到 Base URL 和 YOUR_API_KEY先去官网创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完成后在 API Keys 页面复制 Key。下文统一用 YOUR_API_KEY 占位你实际粘贴时换成自己的那一串。注意 Key 只显示有限次数复制时不要带前后空格和换行否则 Cherry Studio 或 Trae 里会直接报 401。两个固定值先记住Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEYBase URL 这里有两个常见坑。第一不要填 https://taotoken.net 官网地址官网不是 API 入口第二不要自己在末尾加 /v1客户端会按自己的规则拼接路径你再加一层就会出现 /api/v1/v1/... 这类重复路径。Cherry Studio 和 Trae 都用这个 Base URL模型 ID 按控制台模型列表里 DeepSeek 通道对应的 ID 填。TaoToken 在这里的角色只有两个提供 Key提供模型入口。uv init、uv add、main.py、SQLite 文件、建表 SQL、插数据 SQL全部还是本地这套 MCP 在跑。三、可复制配置Cherry Studio 模型供应商、MCP 参数、Trae 的 mcpServers这一节分四小块建议按顺序配。1. Cherry Studio 模型供应商打开 Cherry Studio 的设置进入模型供应商新增或修改一个 OpenAI 兼容类型的供应商API 地址 / Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型选择 DeepSeek 通道对应的模型 ID保存后点一下“检查”或直接发一句“你好”。这一步只验证模型通道不涉及 MCP。如果这里不通先别去折腾 mcpServers。2. Cherry Studio 添加 MCP 服务MCP 参数沿用原文不要把 --db-path 删掉也不要把路径指向别处。假设项目在 ~/TraeProjects/demo数据库想放在 ~/TraeProjects/demo/test.db那么命令填 uv参数按行填--directory ~/TraeProjects/demo run main.py --db-path ~/TraeProjects/demo/test.db如果你的 Cherry Studio 是表单分栏就把 uv 填在命令栏上面六行按顺序填在参数栏。如果它支持直接粘贴 JSON可以写成{ mcpServers: { sqlite-server: { command: uv, args: [ --directory, ~/TraeProjects/demo, run, main.py, --db-path, ~/TraeProjects/demo/test.db ] } } }保存后看 MCP 服务是否变成已连接工具列表里应该出现 read_query、write_query、create_table、list_tables、describe_table、append_insight。3. Trae 添加 MCP 服务Trae 里的 mcpServers 配置和 Cherry Studio 是同一套思路命令还是 uv参数还是那六项。注意两点如果 Trae 的 MCP 配置要求传 JSON就直接用上面的 mcpServers 结构。如果 Trae 运行环境和终端环境不同uv 可能不在 PATH 里这时 command 要写 uv 的绝对路径。4. Trae 的模型通道Trae 里调用 DeepSeek 的模型通道同样按 TaoToken 这套走Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID按控制台里 DeepSeek 通道的 ID 填配完后Trae 的智能体才有能力在对话中决定“我现在要调用 sqlite-server 的 create_table”。MCP 提供工具模型负责选择工具两者缺一不可。四、验证先看模型回话再让智能体用 create_table 建 demo 表验证分两步不要跳。第一步验证模型通道。在 Cherry Studio 里对刚配好的供应商发一句“只回复 ok”。能正常返回说明 Base URL 和 Key 是对的。如果想用命令行确认可以按客户端实际拼接方式请求curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d {model:你的DeepSeek模型ID,messages:[{role:user,content:只回复 ok}]}注意这里的 Base URL 仍然只配到 https://taotoken.net/api/v1/chat/completions 是请求路径不要把它写进 Cherry Studio 或 Trae 的 Base URL 输入框。第二步验证 MCP 调用。在 Trae 智能体里按顺序发这几条指令“用 sqlite-server 的 list_tables 看一下当前有哪些表。”“用 create_table 建一张 demo 表字段是 id INTEGER PRIMARY KEY、name TEXT、note TEXT。”“用 write_query 往 demo 表插入两条测试数据。”“用 read_query 查询 demo 表里的数据。”对应的 SQL 大致是CREATE TABLE demo ( id INTEGER PRIMARY KEY, name TEXT, note TEXT ); INSERT INTO demo (name, note) VALUES (alpha, first), (beta, second); SELECT * FROM demo;成功时你会看到这些结果list_tables 返回当前表列表刚开始可能只有空数组或 SQLite 内部表。create_table 返回 Table created successfully。write_query 返回 affected_rows 为 2。read_query 返回两行记录能对上 alpha 和 beta。如果第一步模型不通第二步一定不会成功。如果第一步通了、第二步里智能体只聊天不调工具优先检查 Trae 的 MCP 面板里 sqlite-server 是否真的加载了工具。五、本篇常见错排查Base URL 加 /v1、~ 未展开、read_query 报错下面这些是本篇配置里最容易踩的坑按出现频率排。1. Base URL 填成官网填成 https://taotoken.net 之后请求会打到官网而不是 API 入口常见表现是 404 或 401。改成 https://taotoken.net/api。2. Base URL 末尾自己加了 /v1客户端一般会自己拼 /v1/chat/completions你再写一层实际路径就变形了。Base URL 只填到 /api。3. Key 带了空格或换行从网页复制 Key 时很容易多带一个换行。粘贴后手动把光标放到末尾检查一遍Cherry Studio 和 Trae 两边都要用同一把有效 Key。4. Cherry Studio 通了Trae 还在用旧地址两边是独立配置。Cherry Studio 的模型供应商改了不代表 Trae 的模型通道也改了。Trae 里也要按 https://taotoken.net/api 和 YOUR_API_KEY 再配一次。5. uv 不在 PATHcommand not found: uv终端里能跑 uv不代表 Trae 或 Cherry Studio 启动 MCP 时的环境能找到 uv。把 command 改成 uv 的绝对路径或者在系统环境变量里确认 uv 所在目录已加入 PATH。6. ~ 没有展开~/TraeProjects/demo 在 shell 里能用但有些客户端启动进程时不会展开 ~。更稳的写法是写绝对路径比如 /Users/yourname/TraeProjects/demoWindows 下写成 C:/TraeProjects/demo 这类正斜杠路径。路径不对时常见报错是找不到 main.py或者数据库被建到了意料之外的位置。7. --db-path 两处不一致Cherry Studio 里指向 test.dbTrae 里却用了默认的 sqlite_mcp_server.db就会出现“我明明插了两条怎么查不到”的情况。两个客户端的参数保持同一个数据库文件。8. MCP 类型选错这个 sqlite-server 是 stdio 模式不是 SSE也不是 HTTP。如果客户端让你选类型选 stdio 或命令模式不要填 URL。9. 用 read_query 去建表main.py 里对工具做了限制read_query 只允许 SELECTwrite_query 不允许 SELECTcreate_table 只允许 CREATE TABLE。如果智能体拿 read_query 去执行 CREATE TABLE会返回 Only SELECT queries are allowed for read_query。让它改用 create_table。10. 依赖没装全uv add mcp[cli] 这一步不要漏。只装 mcp 不装 cli 相关依赖时stdio 启动可能直接失败客户端只显示 MCP 连接断开看不到具体原因。回到项目目录重新执行一次再启动 MCP。11. 同一个 SQLite 文件被两个 MCP 进程同时写Cherry Studio 和 Trae 如果各起了一个 sqlite-server又都指向同一个 db 文件写入时可能出现 database is locked。排障阶段先在一个客户端里验证或者两边用不同的 db 文件。12. 模型通道通了但智能体不调工具有的对话模式不启用工具调用或者当前模型 ID 不适合 Agent 场景。换一个明确支持工具调用的模型 ID并在 Trae 里确认 MCP 工具已经挂到当前智能体上。六、接入配置的下一步这篇的改动点只有一个把 DeepSeek 的模型通道从原地址改到 TaoToken。uv、main.py、--db-path、Cherry Studio 的 MCP 参数、Trae 的 mcpServers 全部保持原样。配通之后智能体才能继续完成“建 demo 表、插 2 条测试数据、查回结果”这条链路。如果你还在创建 Key 或核对 Base URL直接看这两个页面API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你打算把 Trae 长期当成编码 Agent 用MCP 只是其中一环模型通道会反复配到不同工具里可以再看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite最后再强调一次顺序先确认 uv 能启动 main.py再确认 Cherry Studio 和 Trae 的 MCP 面板能看到 sqlite-server最后确认模型通道用的是 https://taotoken.net/api 加 YOUR_API_KEY。三步都通再让智能体去调 create_table成功率会高很多。