MCP Server 桥接

OpenSquilla 可作为 stdio MCP server 桥接运行，供支持 MCP 的客户端使用。当另一个本地 AI 客户端需要通过 Model Context Protocol 调用 OpenSquilla 的 session 工作流时，请使用该桥接。

MCP 桥接是一种集成接入面。它独立于 OpenSquilla 的 Web UI、CLI、channels 以及 gateway 控制台。

前置要求

当需要使用该桥接时，安装带有 MCP extra 的 OpenSquilla：

uv tool install --python 3.12 "opensquilla[recommended,mcp] @ https://github.com/opensquilla/opensquilla/releases/download/v0.4.0/opensquilla-0.4.0-py3-none-any.whl"

启动 OpenSquilla gateway：

opensquilla gateway run

或使用托管的 gateway：

opensquilla gateway start --json
opensquilla gateway status

运行桥接

opensquilla mcp-server run

默认情况下，桥接会连接到：

ws://localhost:18791/ws

使用不同的 gateway：

opensquilla mcp-server run --gateway ws://localhost:18792/ws

该命令会运行一个 stdio MCP server。请将支持 MCP 的客户端配置为以该命令作为 server 进程启动。

安全注意事项

除非有意对外暴露，否则请将 gateway 绑定在 127.0.0.1。
不要在 MCP 客户端配置示例中放入 provider key 或 channel secret。
将 MCP 客户端视为另一个工具调用接入面。OpenSquilla 的同一套 permissions、tools、sessions 与 gateway 状态依然有效。

排障

如果桥接无法启动：

opensquilla gateway status
opensquilla doctor

如果命令报告缺少 MCP 依赖，请使用 mcp extra 重新安装。