# EPICS Channel Access

Даёт агенту доступ к процессным переменным EPICS: чтение, мониторинг и запись, если её разрешить. Пригодится на ускорителях и лабораторных установках.

- 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/protocols/epics
- Обновлён: 2026-09-26
- HTML: https://affpapa.org/nevibecode/mcp/epics-channel-access

## Что делает

Сервер подключается к EPICS по Channel Access и отдаёт агенту инструменты для работы с процессными переменными. Читать можно всё: `get_pv` вернёт значение с единицами, точностью, лимитами и статусом аварии, `get_pvs` заберёт сразу пачку переменных, а `monitor_pv` подпишется на изменения и соберёт статистику за указанное число секунд. Отдельно есть `pv_info` — показывает, какой IOC обслуживает переменную и есть ли у клиента право записи.

Запись вынесена в `put_pv` и `put_pvs` и по умолчанию не работает. Чтобы она вообще прошла, переменная должна попасть в список разрешённых через `--option put_allowlist=`, IOC должен дать доступ на запись, а значение — уложиться в лимиты DRVL/DRVH. Запускать сервер стоит с `--read-only`, пока ответственный за установку не разрешит обратное: запись в PV двигает моторы, открывает затворы и меняет уставки магнитов. В read-only остаётся доступным `apply_safe_state` — аварийная запись заранее прописанных безопасных состояний.

Ничего компилировать не нужно: под капотом caproto, реализация CA на чистом Python, поэтому `libca` не требуется. Проверить связь до подключения к железу можно на встроенном симуляторе — `uvx labmcp-epics --simulate --check` поднимает настоящий CA-сервер на `127.0.0.1` со случайными портами и набором тестовых PV вроде `SIM:TEMP` и `SIM:MTR`. Для реальной сети нужен доступ к IOC или шлюзу: UDP 5064 и 5065, TCP 5064.

## Требования
- Нужно: 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 epics -- uvx labmcp-epics
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-epics <команда>

### Codex

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

### Cursor

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

### GitHub Copilot

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

### 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> epics uvx labmcp-epics
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-epics <команда>

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

## Примеры запросов агенту
- Прочитай `BL7:RING:I` и скажи, есть ли авария.
- Помониторь `SIM:TEMP` десять секунд и покажи статистику.
- Переведи `BL7:SAMPLE:X.STOP` в 1, запись разрешена.

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

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