OpenImageDebugger MCP — MCP-сервер для Claude Code: отладка графики
Даёт ИИ-агенту доступ к буферам изображений в активной сессии gdb или lldb через OpenImageDebugger — показывает пиксели на точке останова, возвращает рендер и статистику.
MIT ★ 251 обновлён 2026-10-23
claude mcp add oid-mcp -- uvx oid-mcpЧто делает OpenImageDebugger MCP
Состоит из двух частей: конечная точка внутри отладчика (oid.py с флагом OID_AGENT=1) пишет файл обнаружения с хостом, портом и токеном; oid-mcp его читает, соединяется и выполняет тяжёлую работу вне хрупкого процесса отладчика — декодирование, рендер в PNG, вычисление статистики, выгрузка .npy. Инструменты работают на точке останова: list_buffers() перечисляет наблюдаемые буферы, view("frame") показывает весь буфер или вырезку по координатам, stats("frame") вычисляет минимум, максимум, среднее, стандартное отклонение и число NaN, values("frame", x=100, y=100, w=4, h=4) возвращает точные числа для крошечной области, dump("frame") сохраняет .npy без потерь, plot("frame") отправляет буфер в окно просмотра.
Требует собранный OpenImageDebugger с развёрнутым oid.py, отладчик с встроенным Python (gdb или Homebrew lldb на macOS), менеджер пакетов uv. Оба компонента должны читать один каталог обнаружения: по умолчанию ~/.oid-agent/, путь меняется переменной OID_AGENT_DIR в обеих средах. Если вы запустили несколько сессий отладки одновременно, каждый инструмент принимает параметр session=<pid>, чтобы выбрать нужную. Функция экспериментальная, протокол может измениться; включайте только в доверенной локальной разработке.
Какие задачи решает
- Проверить значения пикселей буфера на точке останова, не копируя в консоль
- Получить статистику канала изображения (минимум, максимум, число NaN) в отладчике
- Выгрузить буфер из памяти отлаживаемого процесса в
.npyдля анализа - Показать агенту рендер фрагмента матрицы по координатам
- Дать ИИ доступ к изображению, открытому в OID-просмотрщике, без отладчика
Примеры запросов агенту
- Покажи буфер
frame, который сейчас виден в отладчике - Вычисли статистику буфера
image_dataна текущей точке останова - Выгрузи буфер
matrixв.npyи сохрани в./debug_dumps/
Как установить OpenImageDebugger MCP
Командой платформы
claude mcp add oid-mcp -- uvx oid-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from oid-mcp <команда>
Командой платформы
codex mcp add oidmcp -- uvx oid-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from oid-mcp <команда>
Файл настроек
{
"mcpServers": {
"oidmcp": {
"command": "uvx",
"args": [
"oid-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from oid-mcp <команда>
Файл настроек
{
"servers": {
"oidmcp": {
"type": "stdio",
"command": "uvx",
"args": [
"oid-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from oid-mcp <команда>
Командой платформы
gemini mcp add oidmcp uvx oid-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from oid-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об OpenImageDebugger MCP
Как установить OpenImageDebugger MCP в Claude Code?
Выполните claude mcp add oid-mcp -- uvx oid-mcp в терминале или добавьте запись в .mcp.json с командой uvx и аргументом oid-mcp.
Что делает OpenImageDebugger MCP?
Соединяет ИИ-агента с буферами изображений в активной сессии gdb или lldb: агент видит список буферов, получает рендер, статистику каналов, точные значения пикселей и выгружает .npy для офлайн-анализа.
Что нужно для работы OpenImageDebugger MCP?
Собранный OpenImageDebugger с развёрнутым oid.py, отладчик с Python (gdb или Homebrew lldb), менеджер uv и флаг OID_AGENT=1 при запуске отладчика. Отладчик и MCP-сервер должны читать один каталог обнаружения.