MCP 服务器本地化部署最容易卡住的地方不是 Excel MCP、filesystem MCP 或顺序思考 MCP 起不来而是 Cherry Studio 里没有可用的模型通道MCP 工具侧已经监听 SSE对话侧却发不出请求或者发了请求也调不动刚挂上的工具。这里用 TaoToken 只补 Key 和 Base URL 这一条模型通道官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcherry-mcp。Excel 读写、目录列举、顺序思考仍然由本地 MCP Server 和 mcp-proxy 完成。下面按 Node 20.19.2、excel-mcp-server、modelcontextprotocol/server-filesystem、mcp-sequential-thinking、Office-Word-MCP-Server 到 Cherry Studio 联调的顺序把模型服务改接 TaoToken。1. MCP 服务器本地化部署后Cherry Studio 模型为什么调不动很多本地部署流程会先把 MCP 服务跑起来Excel MCP 用 stdio 或 SSEFilesystem MCP 指向 /data/test顺序思考 MCP 提供结构化思考Word MCP Server 提供文档创建与编辑。接着用 mcp-proxy 把 stdio 转成 SSE 端口8080 给 Excel8081 给文件系统8082 给顺序思考8084 给 Word。做到这一步MCP 工具侧看起来已经通了。问题出现在 Cherry Studio 多模型对话联调。Cherry Studio 可以管理多模型对话、知识库、AI 绘画和翻译也可以接 MCP 工具但模型服务里如果没有可用的 OpenAI 兼容通道发指令时要么没有返回要么模型根本不会触发 MCP 工具。此时再去查 mcp-proxy 的 8080/8081/8082/8084 端口端口还在监听再去查 excel-mcp-server进程也没退出。真正缺的是对话客户端的模型通道。这篇的处理方式很明确MCP 服务器继续本地化部署TaoToken 只负责在 Cherry Studio 里提供 Key、Base URL 和模型 ID 这条模型通道。不要把它理解成替代本地 MCP 服务Excel 读写、目录列举、顺序思考、Word 文档操作仍然是本地 MCP Server 和 mcp-proxy 在做。2. Node 20.19.2 环境与四个 MCP Server 的本地启动先确认 Node 版本。原文使用的是 Node 20.19.2 的 glibc 217 构建包适合一些旧系统。下载、解压、配置 PATHwget https://unofficial-builds.nodejs.org/download/release/v20.19.2/node-v20.19.2-linux-x64-glibc-217.tar.xz tar Jxvf node-v20.19.2-linux-x64-glibc-217.tar.xz cd node-v20.19.2-linux-x64-glibc-217在 /etc/profile 里追加export PATH$PATH:/data/node-v20.19.2-linux-x64-glibc-217/bin然后生效source /etc/profile node -v npm -v如果 node -v 不是 v20.19.2先用绝对路径确认再检查 PATH 顺序。npx 后续会用来拉起 modelcontextprotocol/server-filesystem。Excel MCP Server 是读写 MS Excel 数据的 MCP 服务器支持读取文本值、写入文本值、读取公式、写入公式。先决条件是 Python 3.10 或更高版本。它提供 Linux 二进制包也可以按发布页下载wget https://github.com/negokaz/excel-mcp-server/releases/download/v0.10.3/excel-mcp-server_Linux_x86_64.tar.gz tar zxvf excel-mcp-server_Linux_x86_64.tar.gz服务支持 stdio 和 SSE 两种传输。stdio 适合本地开发或直接集成SSE 适合远程连接uvx excel-mcp-server stdio uvx excel-mcp-server sseFilesystem MCP 服务器负责文件系统操作包括读写文件、创建/列出/删除目录、移动文件或目录、搜索文件、获取文件元数据。指定可操作目录例如 /data/testnpx modelcontextprotocol/server-filesystem /data/test顺序思考 MCP 服务器 mcp-sequential-thinking 提供结构化思考框架把复杂问题拆成顺序思想并跟踪进度。安装和运行git clone https://github.com/arben-adm/mcp-sequential-thinking.git cd mcp-sequential-thinking uv pip install -e .[all] mcp-sequential-thinkingOffice-Word-MCP-Server 用于创建、读取和操作 Word 文档能做文档管理、内容创建、富文本格式、表格格式等操作。安装依赖并启动git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git cd Office-Word-MCP-Server pip install -r requirements.txt python word_mcp_server.py这四个服务分别在不同的终端或后台进程中运行。如果只是直接运行关闭终端就会退出后面用 mcp-proxy 代理时要保证它们能被代理进程正确拉起或者用持久化方式运行。3. mcp-proxy 把 stdio 转成 8080/8081/8082/8084 SSE 端口mcp-proxy 负责在不同传输之间切换支持 stdio 到 SSE 以及 SSE 到 stdio。客户端通过 SSE 与远程服务器通信时即使原服务只支持 stdio也可以由 mcp-proxy 暴露 SSE 端口。安装pip install mcp-proxy接着把四个 MCP 服务分别代理到固定端口。Excel 用 8080Filesystem 用 8081顺序思考用 8082Word 用 8084mcp-proxy --sse-port8080 --sse-host0.0.0.0 uvx excel-mcp-server stdio mcp-proxy --sse-port8081 --sse-host0.0.0.0 npx modelcontextprotocol/server-filesystem /data/test mcp-proxy --sse-port8082 --sse-host0.0.0.0 mcp-sequential-thinking mcp-proxy --sse-port8084 --sse-host0.0.0.0 python word_mcp_server.py 生产或长期联调时不要只依赖SSH 断开后可能被挂断。可以用 nohup 把日志落到文件nohup mcp-proxy --sse-port8080 --sse-host0.0.0.0 uvx excel-mcp-server stdio /var/log/mcp-8080.log 21 nohup mcp-proxy --sse-port8081 --sse-host0.0.0.0 npx modelcontextprotocol/server-filesystem /data/test /var/log/mcp-8081.log 21 nohup mcp-proxy --sse-port8082 --sse-host0.0.0.0 mcp-sequential-thinking /var/log/mcp-8082.log 21 nohup mcp-proxy --sse-port8084 --sse-host0.0.0.0 python word_mcp_server.py /var/log/mcp-8084.log 21 检查监听状态ss -lntp | grep -E :8080|:8081|:8082|:8084预期能看到 0.0.0.0:8080、0.0.0.0:8081、0.0.0.0:8082、0.0.0.0:8084。若某个端口没有出现先看对应日志。常见原因是 uvx、npx、python 不在 PATH或者 stdio 子进程启动参数不对。mcp-proxy 只做协议转发不负责模型推理端口通不等于 Cherry Studio 能对话。4. 在 Cherry Studio 里新增 TaoToken OpenAI 兼容供应商MCP 端口都监听以后回到 Cherry Studio。原来的流程是直接打开 Cherry Studio 配置多模型但此时模型服务里可能只有内置供应商或空配置发指令调不动 MCP。这里先打开 TaoToken 官网注册并创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcherry-mcp创建 Key 后回到 Cherry Studio进入模型服务设置新增自定义 OpenAI 兼容供应商。可复制配置如下配置项填写值供应商类型OpenAI 兼容供应商名称TaoTokenBase URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID从 TaoToken 官网模型广场复制Base URL 只填到/api不要手动补/v1不要带 UTM 参数。API Key 粘贴刚创建的那把前后不要有空格。模型 ID 以官网模型广场为准不要自己拼写。保存后在 Cherry Studio 的对话模型列表里选中这个供应商下的模型。如果 Cherry Studio 的 MCP 设置也需要手动录入可以把四个 SSE 地址写成类似下面的结构{ mcpServers: { excel: { type: sse, url: http://127.0.0.1:8080/sse }, filesystem: { type: sse, url: http://127.0.0.1:8081/sse }, sequential-thinking: { type: sse, url: http://127.0.0.1:8082/sse }, word: { type: sse, url: http://127.0.0.1:8084/sse } } }注意是把 MCP 地址填到 MCP 配置不是填到模型 Base URL。模型 Base URL 始终是https://taotoken.net/api。TaoToken 在这里只提供模型通道Excel 读写、目录列举、顺序思考这些活仍然由本地 MCP Server 和 mcp-proxy 完成。5. 一次读写表格指令验证模型返回并触发 MCP 工具配置完成后在 Cherry Studio 里选择 TaoToken 供应商下的模型开启 excel 对应的 MCP 工具。先发一句不需要工具的短指令确认模型通道只回复 ok如果模型能返回 ok说明 Key、Base URL、模型 ID 这条通道已经通了。接下来发需要读写表格的指令读取 /data/test/demo.xlsx 的 A1 单元格内容如果为空就写入 TaoToken-MCP-OK然后把 A1 读回来告诉我结果。这条指令同时检查两件事模型请求能否正常返回以及模型是否会调用刚挂上的 Excel MCP 工具。成功时Cherry Studio 会返回类似“已写入当前 A1 为 TaoToken-MCP-OK”的结果同时可以查看 mcp-proxy 的 8080 日志应该能看到 tools/call 之类的请求记录。再检查 SSE 端口是否正常转发ss -lntp | grep -E :8080|:8081|:8082|:8084 timeout 3 curl -N http://127.0.0.1:8080/ssecurl -N能连上 SSE 并看到事件流说明 8080 转发正常。文件系统、顺序思考、Word 分别换 8081、8082、8084 做同样的连通性检查。若模型能返回但不调用工具优先检查 Cherry Studio 里该会话是否启用了 MCP 工具以及当前模型是否适合工具调用场景。6. 本篇相关错误排查MCP 本地化部署之后 Cherry Studio 调不动常见不是 MCP 服务本身挂了而是模型服务配置和 MCP 接入地址混在一起。下面只列本篇容易遇到的几类。第一类Base URL 填写错误。Cherry Studio 的模型服务里Base URL 填https://taotoken.net/api不要多写/v1也不要带 UTM 查询参数。如果客户端已经自动拼接路径手动再补一层会导致请求异常。第二类模型 ID 写错。模型 ID 必须从 TaoToken 官网模型广场复制不能自己猜名字。模型服务里选的模型如果不存在对话侧会直接失败MCP 工具自然也不会被触发。第三类MCP SSE 地址少了/sse。Cherry Studio 的 MCP 配置里Excel 是http://127.0.0.1:8080/sseFilesystem 是http://127.0.0.1:8081/sse顺序思考是http://127.0.0.1:8082/sseWord 是http://127.0.0.1:8084/sse。只写端口通常连不上。第四类mcp-proxy 启动后立刻退出。多数是 stdio 子进程命令找不到。先确认which uvx、which npx、which python的路径再在 mcp-proxy 命令里使用绝对路径或者用 nohup 时显式带上 PATH。第五类端口占用。用lsof -i :8080或ss -lntp | grep 8080查冲突进程换端口后同步修改 Cherry Studio 里的 SSE 地址。第六类Excel 写入失败。检查/data/test/demo.xlsx是否存在、当前进程是否有写权限、文件是否被其他程序占用。Word MCP 则要确认python word_mcp_server.py使用的是安装了 requirements.txt 依赖的那个解释器。7. 把同一把 TaoToken Key 复用到终端与 Claude CodeCherry Studio 里模型返回正常、8080 端口也能看到 MCP 请求之后如果还要把同一把 Key 放到终端脚本、CI 或 Claude Code先在控制台创建和管理 Key再按 Claude Code 接入文档配置环境变量或配置文件。入口如下API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentcherry-mcputm_campaignrewriteClaude Code 接入文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentcherry-mcputm_campaignrewrite如果准备把 MCP 工具链和模型通道长期挂在 Agent 任务里减少每次手工换 Key 和改 Base URL可以继续看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcherry-mcputm_campaignrewrite这样 Cherry Studio 负责对话和触发工具mcp-proxy 负责把 8080/8081/8082/8084 的 MCP 工具暴露出来TaoToken 负责模型请求。三者各自跑通再联调就不容易在“模型调不动”和“工具没挂上”之间来回猜。