雷恩设置

运维部署 社区

技能解读

当前原文的自动摘译,尚未人工审校。

版本检查

默默地获取https://raw.githubusercontent.com/Canner/wren-engine/main/skills/versions.json。将wren-mcp-setup键与该技能的版本进行比较(来自上面的前文)。如果远程版本较新,请在继续之前通知用户:有较新版本的 wren-mcp-setup 技能可用。更新为:

第 1 步 - 询问工作空间路径

询问用户:您的主机上的哪个目录应安装为 MCP 工作区?这是读取和写入 MDL 文件和 YAML 项目目录的位置。 (例如:~/wren-workspace)如果用户没有偏好,建议创建一个专用目录,例如~/wren-workspace:

检查是否有较新的图像

在启动容器之前,请验证注册表中是否有更新的 wren-engine-ibis 映像可用。如果图像从未被拉取(第一次设置),只需拉取它:如果图像本地已存在,则将本地摘要与远程摘要进行比较以检测更新:注意:如果wren-mcp容器已在运行并且拉取了新图像,请在继续之前停止并删除旧容器:

Docker 主机提示

严重:容器无法直接到达主机的localhost。如果您的数据库在主机上运行,​​请使用 host.docker.internal 而不是 localhost 或 127.0.0.1 作为主机名。当 Web UI 检测到您可能正在连接到本地数据库时,会显示一条提示: Original · Inside Docker localhost · host.docker.internal 127.0.0.1 · host.docker.internal

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
运维部署
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Docker
运行环境要求
Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步 - 询问工作空间路径

询问用户:主机上的哪个目录应安装为 MCP 工作区?这是读取和写入 MDL 文件和 YAML 项目目录的位置。 (例如:`~/wren-workspace`)如果用户没有偏好,建议创建一个专用目录,例如`~/wren-workspace`:

02
第 3 步 — 通过 Web UI 配置连接信息

通过 http://localhost:9001 打开 Web UI。 Web UI 提供: 只读模式 — 切换以防止 AI 代理调用 `deploy`、`deploy_manifest`、`list_remote_tables` 或 `list_remote_constraints`。对于只读查询访问很有用。 MDL 状态 — 显示当前部署的 MDL(模型、列、数据源)。连接信息 — 选择数据源类型并填写凭据。单击“保存连接”进行测试并保留。

03
第 4 步 — 配置 Claude Code MCP

Claude Code 使用 Streamable-http 传输连接到容器化 MCP 服务器。通过Claude Code CLI(推荐):或者手动添加到`mcpServers`下的`~/.claude/settings.json`:添加后,重新启动Claude Code,以便将新的MCP服务器加载到会话中。确认: 注意:配置文件是`~/.claude/settings.json`,而不是`~/.claude.json`。在会话已运行时添加 MCP 服务器在会话重新启动之前不会生效。

04
第 6 步 — 验证连接

要求 AI 代理运行健康检查: 预期响应:`SELECT 1` 返回成功结果。如果健康检查失败,请参阅下面的故障排除。

05
第 7 步 — 加载 MDL 并开始查询

选项 A — 启动时自动加载(推荐):在启动容器之前将编译好的 `mdl.json` 放入 `<WORKSPACE_PATH>/target/mdl.json` 中。容器在启动时读取 `MDL_PATH` 并记录: 选项 B — 通过 Web UI 部署:打开 `http://localhost:9001`,在 MDL 编辑器中粘贴或编辑 MDL JSON,然后单击保存并部署。选项 C — 通过 MCP 工具部署(容器运行后):

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。