★ FEATURED ARTICLE Strata MCP 工具配置完整指南改一个 JSON 文件本地模型就能读写文件、调用搜索【免费下载链接】StrataQwen3.8-Flash-Next on any consumer hardware: one-click install for Windows / Linux. Strata inference engine, OpenAI/Anthropic API on localhost, optional image input.项目地址: https://gitcode.com/gh_mirrors/strata11/StrataStrata 是一个在消费级显卡上跑 125B 参数 Qwen3.8-Flash-Next 的本地推理引擎它的 MCP 工具机制让本地模型能读写文件、调用搜索服务器全程不出本机。改一个 JSON 文件再重启浏览器里就能实时看到每一次工具调用。下面以让模型读完我的笔记目录并总结为例边做边讲。给 mcp_servers 块加两个服务器配置就写完了先说结论所有 MCP 配置都写在 Strata 安装目录下的strata-模型名.json里合并两个键即可生效不需要装任何 MCP SDK——客户端就是一份纯标准库代码见 serve/mcp.py。最小可用的配置长这样{ mcp_servers: { files: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, D:\\notes] }, search: { url: http://127.0.0.1:3000/mcp, headers: {Authorization: Bearer 你的密钥} } }, mcp: {timeout_s: 60, max_result_chars: 20000, max_rounds: 8} }两种写法对应两类服务器command开头的是stdio 传输Strata 会像终端里敲命令一样把它拉起来通过标准输入输出交换 JSON-RPC 消息用npx启动时需要本机装 Node.jsurl开头的是Streamable HTTP 传输把 JSON-RPC 直接 POST 到那个地址。⚠️ 旧版 SSE 协议不支持条目里写了type: sse会在启动时报错退出多数服务器在/mcp路径提供新传输。两个容易忽略的细节。其一Claude Desktop 的claude_desktop_config.json可以整个文件挂进来启动时加--mcp-config 路径\claude_desktop_config.json配置里同时出现同名服务器时文件中的条目优先给某个条目加disabled: true则把它排除。其二所有工具在交给模型之前会被改写成服务器名__工具名的形式两个服务器都提供search也不会撞车调用时按名字路由回各自的服务器。配置只改文件下一步先不动服务用一条命令验证它有没有被正确读进来。先跑一条命令不重启也能验证配置在 Strata 目录执行python -m serve.mcp strata-模型名.json它会把配置里的每个服务器真实拉起来然后打印一段 JSON每台的statusready/failed、传输方式、提供的工具清单以及末尾的工具总数。全ready才去重启 Strata能省掉一轮盲猜。 如果某台显示failederror字段会直接给出原因比如could not start就是找不到command里那个程序。mcp块的四个参数及默认值参数默认作用什么时候要动它timeout_s60单次工具调用的等待上限秒工具正常就要跑一分多钟时调大max_result_chars20000工具结果超过该长度就截断并注明原文有多长常读大文件想多留点内容时调大max_rounds8一次回答内连续调工具的最大轮数模型反复调工具不收敛时调小start_timeout_s120服务器启动 工具列表的等待上限npx首次下载慢导致 Starting 太久时调大⚠️ 这四个值必须是正数写错类型或出现 0、负数、小数max_rounds要求整数会让 Strata 直接拒绝启动错误信息里会指明是哪个键。命令行验证通过后把服务器交给服务本体打开浏览器看状态。Monitor 页看实时状态聊天里看调用块重启后网页应用默认http://127.0.0.1:8080的 Monitor 页会自动列出每台服务器状态、传输方式、工具清单和总数数据来自GET /mcp接口。配置里如果设了api_key这个接口也要带 key 才能看。聊天这边不用手动开前端每次请求都会带上strata_mcp: trueSampling 抽屉里的 Use tools from MCP servers 开关默认打开。模型决定调用files__list_directory时回答里会插一个可展开的小块依次显示工具名、参数和结果工具报错、超时或服务进程中途挂掉都会变成一段error: ...文本交回模型由模型自己决定重试还是绕过去聊天流不会断。点 Stop 不只是掐断回答还会向服务器发一条取消通知正在跑的工具一并终止。边界也很清楚MCP 工具只对这个 Strata 页面生效。你的脚本、SDK 走 API 时看到的接口和从前完全一致请求里不带strata_mcp: true就一个工具都看不见。反过来仓库里还有个方向相反的 tools/strata_mcp.py那是把 Strata 本身暴露成 MCP 服务器给 Claude Code 之类的助手管理与本文配置无关。配置、验证、查看都过了剩下的问题是状态不对时从哪查起。服务器卡在 Starting 或 Failed 时先查什么先给排查表状态是 Monitor 页直接能看到的Monitor 状态先查什么代码里的依据Starting 超过 2 分钟npx首次要下包属正常调大start_timeout_s再不行确认 Node.js 已安装启动超时即记 failedFailederror 含could not startcommand写错、程序不在 PATH见 serve/mcp.pyFailed提示old SSE transport换到该服务器的 Streamable HTTP 地址通常是/mcp启动时校验配置工具调用时偶发the server stopped进程中途崩溃下一次调用会自动重拉崩溃后状态记为 stopped反复调用反复失败failed的服务器每 10 秒才重试一次不疯狂重启不用手动干预见 serve/test_mcp.py 对应测试另外两件事值得知道模型某次回答在半句工具调用就结束时这个调用不会执行页面显示 Not run不会出现空参数误触发跨站脚本带strata_mcp: true来请求会被直接拒绝403 或 415。最后把谁能用这些工具这件事定下来。权限、提示词注入与局域网暴露三道防线MCP 工具以你当前的用户权限在本地执行而且调用时机由模型根据它读到的内容决定——一个网页或文件里恰好写了一段像指令的文本就可能诱导它动手。docs/DETAILS.md 的 Security 一节给出的建议可以落成三条防线做法依据最小目录授权文件系统服务器只传它必须读的目录如例子里的D:\notes别给整盘官方 Security 一节只读优先能换只读工具就不给写、删能力来源不可信的服务器不加官方 Security 一节暴露面收口若用--host 0.0.0.0让局域网其他设备访问务必设--api-key工具调用本身已限制只响应 Strata 自己页面的请求校验 Origin JSON 内容类型serve/server.py结果被截断、工具报错属于正常降级截断会注明原文长度报错变成error:文本两者都不会让上下文被撑爆或让会话中断。防线都就位后按下面三步收尾。编辑strata-模型名.json合并mcp_servers文件系统服务器只给所需目录运行python -m serve.mcp strata-模型名.json确认每台都是ready再重启 Strata到 Monitor 页核对状态与工具总数在聊天页发一句总结 D:\notes 里的笔记确认工具块从参数到结果完整走完再点一次 Stop 验证进行中的工具会被终止。【免费下载链接】StrataQwen3.8-Flash-Next on any consumer hardware: one-click install for Windows / Linux. Strata inference engine, OpenAI/Anthropic API on localhost, optional image input.项目地址: https://gitcode.com/gh_mirrors/strata11/Strata创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
