# orcaslicer-mcp

MCP-сервер связывает ИИ-агента с запущенным OrcaSlicer: помогает менять настройки, готовить модели к печати и разбирать результаты нарезки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 78
- Автор: MaxEllis
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/MaxEllis/orcaslicer-mcp
- Обновлён: 2026-10-12
- HTML: https://affpapa.org/nevibecode/mcp/orcaslicer-mcp

## Что делает

Сервер управляет открытым OrcaSlicer: загружает и размещает модели, меняет параметры, запускает нарезку и получает сводку по времени, расходу филамента и потоку для разных частей модели. Агент также может сравнить варианты настроек и проверить профиль расчётами на физические ограничения принтера. Для работы нужен запущенный OrcaSlicer.

Справочник настроек работает офлайн и содержит подписи, подсказки, типы значений, диапазоны и значения по умолчанию из OrcaSlicer. При работе с несколькими филаментами изменение пресета стирает несохранённые переопределения во всех группах: сначала внесите изменения филамента, затем настройки печати. Запросы к принтеру при использовании его инструментов доступны только для чтения; команды принтеру не отправляются.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `ORCA_API_TOKEN`, `ORCA_API_URL`, `ORCA_MCP_ALLOW_KEYS`, `ORCA_PRINTER_URL`, `ORCA_PRINTER_API_KEY`, `ORCA_PRINTER_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env ORCA_API_TOKEN=<ORCA_API_TOKEN> --env ORCA_API_URL=<ORCA_API_URL> --env ORCA_MCP_ALLOW_KEYS=<ORCA_MCP_ALLOW_KEYS> --env ORCA_PRINTER_URL=<ORCA_PRINTER_URL> --env ORCA_PRINTER_API_KEY=<ORCA_PRINTER_API_KEY> --transport stdio orcaslicer-mcp -- uvx orcaslicer-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from orcaslicer-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add orcaslicer-mcp --env ORCA_API_TOKEN=<ORCA_API_TOKEN> --env ORCA_API_URL=<ORCA_API_URL> --env ORCA_MCP_ALLOW_KEYS=<ORCA_MCP_ALLOW_KEYS> --env ORCA_PRINTER_URL=<ORCA_PRINTER_URL> --env ORCA_PRINTER_API_KEY=<ORCA_PRINTER_API_KEY> -- uvx orcaslicer-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from orcaslicer-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "orcaslicer-mcp": {
            "command": "uvx",
            "args": [
                "orcaslicer-mcp"
            ],
            "env": {
                "ORCA_API_TOKEN": "<ORCA_API_TOKEN>",
                "ORCA_API_URL": "<ORCA_API_URL>",
                "ORCA_MCP_ALLOW_KEYS": "<ORCA_MCP_ALLOW_KEYS>",
                "ORCA_PRINTER_URL": "<ORCA_PRINTER_URL>",
                "ORCA_PRINTER_API_KEY": "<ORCA_PRINTER_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from orcaslicer-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "orcaslicer-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "orcaslicer-mcp"
            ],
            "env": {
                "ORCA_API_TOKEN": "<ORCA_API_TOKEN>",
                "ORCA_API_URL": "<ORCA_API_URL>",
                "ORCA_MCP_ALLOW_KEYS": "<ORCA_MCP_ALLOW_KEYS>",
                "ORCA_PRINTER_URL": "<ORCA_PRINTER_URL>",
                "ORCA_PRINTER_API_KEY": "<ORCA_PRINTER_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from orcaslicer-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ORCA_API_TOKEN=<ORCA_API_TOKEN> -e ORCA_API_URL=<ORCA_API_URL> -e ORCA_MCP_ALLOW_KEYS=<ORCA_MCP_ALLOW_KEYS> -e ORCA_PRINTER_URL=<ORCA_PRINTER_URL> -e ORCA_PRINTER_API_KEY=<ORCA_PRINTER_API_KEY> orcaslicer-mcp uvx orcaslicer-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from orcaslicer-mcp <команда>

## Когда брать
- проверить, какие части модели занимают больше времени печати
- сравнить время и расход филамента для вариантов высоты слоя
- найти настройки OrcaSlicer и узнать их допустимые значения
- проверить профиль на ограничения потока, температуры и геометрии
- разместить модель на столе и запустить нарезку

## Примеры запросов агенту
- Проверь, какие части модели сильнее всего влияют на время печати.
- Сравни варианты высоты слоя по времени, расходу филамента и предупреждениям.
- Проверь этот профиль на физические ограничения принтера перед печатью.

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md