内容
# 章鱼切片器 MCP
**通过 AI 驱动章鱼切片器。** 章鱼切片器 MCP 是一个 [MCP](https://modelcontextprotocol.io) 服务器，允许克劳德（桌面版或代码版，或任何 MCP 客户端）操作一个真实的、正在运行的章鱼切片器：加载模型、排列板块、调整设置、切片和结果分析 - 实时进行，每次更改都在 GUI 中可见。
切片器保持权威并在您的机器上运行。服务器不包含 LLM，也不进行云调用；它只与本地主机（或您明确允许的主机）上的章鱼切片器通信。
## 工作原理
两个部分：
1. **章鱼切片器的 MCP 版本** - 章鱼切片器 2.3.2，带有嵌入式本地控制 API（令牌身份验证，默认仅限 localhost）。从 [发布页面](https://github.com/maxellis/OrcaSlicer/releases) 获取；如果您的平台尚未有二进制文件，请从源代码构建 `remote-api` 分支。
2. **此软件包（`orcaslicer-mcp`）** - 连接您的 AI 客户端到该版本的 MCP 服务器。
原始章鱼切片器没有控制 API；MCP 服务器需要上述版本。
> **更新：** 始终从 [发布页面](https://github.com/maxellis/OrcaSlicer/releases) 获取新版本，绝不从应用程序内部获取。对于 **mcp.2 及以后版本**，禁用章鱼切片器的内置更新器（如果启用，它会提供*原始*章鱼切片器，这会删除控制 API）。如果您使用的是旧版本，并且出现“新版本可用”的提示，请单击 **跳过此版本**。
## 快速入门
您需要安装 [uv](https://docs.astral.sh/uv/getting-started/installation/) （它提供运行服务器的 `uvx` 命令）- 一行命令：`curl -LsSf https://astral.sh/uv/install.sh | sh` 在 macOS/Linux 上，或 `irm https://astral.sh/uv/install.ps1 | iex` 在 Windows 上使用 PowerShell。
1. 安装并启动章鱼切片器的 MCP 版本，并完成一次性首次运行设置（选择您的打印机）。在全新安装时，章鱼切片器可能会显示 **“Bambu 网络插件所需”** 对话框 - 点击 **稍后跳过**；该插件仅用于 Bambu 云打印，在此处不需要。（控制 API 在首次运行设置完成后启动。）
2. 在章鱼切片器中：**首选项** （Ctrl+P） **→ 远程 API → 启用远程 API**，然后复制该页面上显示的 API 令牌。（除非您还启用了“允许 LAN 访问”，否则访问仅限 localhost。）
3. 将服务器添加到您的 MCP 客户端配置中（克劳德桌面版 `claude_desktop_config.json`，或克劳德代码版的项目 `.mcp.json`）：
```json
{
"mcpServers": {
"orcaslicer": {
"command": "uvx",
"args": ["orcaslicer-mcp"],
"env": {
"ORCA_API_TOKEN": "<从首选项中获取的令牌>"
}
}
}
}
```
`ORCA_API_URL` 默认值为 `http://127.0.0.1:13130` - 仅当您更改了端口或在另一台机器上运行章鱼切片器（并启用了 LAN 访问）时才设置它。
4. 重启您的客户端并询问：*“加载 benchy.stl，切片它与当前配置文件，并告诉我打印时间。”*
## 克劳德可以执行的操作
- **板块和模型：** `load_model`, `list_objects`, `transform_object`, `duplicate_object`, `delete_object`, `arrange_plate`, `auto_orient`, `check_placement`, `diagnose_plate`, `get_job_status`
- **设置：** `get_config`, `set_config`, `find_config_keys`, `describe_setting`, `search_settings`, `compare_settings`, `set_layer_height`, `set_height_range`, `set_object_config` （每对象覆盖）
- **预设：** `list_presets`, `select_preset`, `get_preset_config`, `edit_preset`, `save_preset`, `rename_preset`, `delete_preset`
- **切片：** `slice`, `slice_and_wait`, `apply_and_slice`, `cancel_slice`, `get_slice_status`, `get_slice_warnings`, `get_slice_breakdown` （每功能时间/流量分析），`get_gcode`
- **实时状态和事件：** `get_status`, `watch_events`
### 设置智能
- **`consult(query)`** - 精选的切片知识加上您保存的笔记，按主题、症状或目标组织。
- **`check_profile_physics(changes?)`** - 确定性健全性门控：覆盖提出的更改到实时配置并运行流量/温度/几何/冷却数学。裁决：`ok`, `warnings`, 或 `blocked`.
- **`remember(note, scope)`** - 持久化机器/用户/项目事实以供未来会话使用，作为 `~/.orcaslicer-mcp/notes/` 中的纯本地文件（可通过 `ORCA_MCP_NOTES_DIR` 重新定位）。
此外，还有一个离线设置参考：权威标签/工具提示/类型/范围/枚举/默认值，适用于约 800 个章鱼切片器设置，随软件包捆绑。
## 安全
- 控制 API 默认仅绑定到 **127.0.0.1**；LAN 访问是首选项中的显式选择。
- 每个请求都必须携带 API 令牌；章鱼切片器在首次运行生成它，并在任何时候都可以重新生成。
- MCP 服务器是一个本地标准输入/输出进程。无遥测，无云。
## 开发
```bash
uv venv && uv pip install -e ".[dev]"
uv run pytest # 单元测试（模拟 API）+ 有保护的实时烟雾测试
```
实时烟雾测试除非 `ORCA_API_URL` / `ORCA_API_TOKEN` 指向正在运行的章鱼切片器 MCP 版本，否则跳过。
开发者文档 - 协议笔记、设计规格、验证结果 - 位于 [`docs/`](docs/) 中。
## 状态
早期公开版本（软启动）。服务器通过 ~170 个单元测试和实际打印工作流程进行测试；预构建的章鱼切片器 MCP 版本适用于 Windows、macOS 和 Linux，可在 [发布页面](https://github.com/maxellis/OrcaSlicer/releases) 上获取。欢迎提出问题和报告。
## 许可证
AGPL-3.0 - 与章鱼切片器相同，从其源代码中导出捆绑的设置模式。参见 [LICENSE](LICENSE)。
