# JULABO Circulator

Управляет лабораторными термостатами и циркуляторами JULABO через последовательный порт или USB. Помогает контролировать нагрев, читать датчики и ждать выхода на заданную температуру.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23
- Автор: K-Dense-AI
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/K-Dense-AI/lab-instrument-mcps/tree/HEAD/servers/chemistry/julabo-circulator
- Обновлён: 2026-09-26
- HTML: https://affpapa.org/nevibecode/mcp/julabo-circulator

## Что делает

Сервер связывает ИИ-агента с циркуляторами серий CORIO, MAGIO и DYNEO по протоколу команд JULABO через USB или нуль-модемный кабель RS-232. Модели PRESTO используют похожий набор команд, но производителем пакета на реальном оборудовании пока не тестировались. Доступны инструменты для считывания температуры ванны, внешнего датчика Pt100, процента мощности нагрева или охлаждения, а также для пуска и остановки насоса.

Для работы на приборе обязательно включить режим удалённого управления через встроенное меню (`rEM` для CORIO или Remote control для MAGIO и DYNEO). Без этого термостат отвечает на информационные запросы, но отвергает любые команды на изменение параметров. Заводские параметры RS-232 требуют 4800 бод, 7 бит данных, чётный паритет и один стоп-бит.

Встроенные ограничения по умолчанию рассчитаны на водяную ванну в диапазоне от 5 до 90 °C. Если в ванну залит гликоль или силиконовое масло, безопасные пределы `min_temperature_c` и `max_temperature_c` задают вручную при запуске. Инструмент `wait_for_temperature` опрашивает термостат до стабилизации показаний и автоматически останавливается при сигнале тревоги.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> --transport stdio julabo-circulator -- uvx labmcp-julabo
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-julabo <команда>

### Codex

**Командой платформы**
```bash
codex mcp add julabo-circulator --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> -- uvx labmcp-julabo
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-julabo <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "julabo-circulator": {
            "command": "uvx",
            "args": [
                "labmcp-julabo"
            ],
            "env": {
                "LABMCP_ADDRESS": "<LABMCP_ADDRESS>",
                "LABMCP_SIMULATE": "<LABMCP_SIMULATE>",
                "LABMCP_READ_ONLY": "<LABMCP_READ_ONLY>",
                "LABMCP_LIMITS": "<LABMCP_LIMITS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-julabo <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "julabo-circulator": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "labmcp-julabo"
            ],
            "env": {
                "LABMCP_ADDRESS": "<LABMCP_ADDRESS>",
                "LABMCP_SIMULATE": "<LABMCP_SIMULATE>",
                "LABMCP_READ_ONLY": "<LABMCP_READ_ONLY>",
                "LABMCP_LIMITS": "<LABMCP_LIMITS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-julabo <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e LABMCP_ADDRESS=<LABMCP_ADDRESS> -e LABMCP_SIMULATE=<LABMCP_SIMULATE> -e LABMCP_READ_ONLY=<LABMCP_READ_ONLY> -e LABMCP_LIMITS=<LABMCP_LIMITS> julabo-circulator uvx labmcp-julabo
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-julabo <команда>

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

## Примеры запросов агенту
- Проверь статус термостата JULABO на порту COM3 и прочитай текущую температуру ванны.
- Установи уставку 37 °C, запусти циркуляцию и подожди, пока ванна не стабилизируется с точностью 0.2 °C.
- Экстренно останови циркуляционный насос и выведи последние сообщения об ошибках.

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

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