OmniSim MCP
MCP-сервер OmniSim дает агенту 46 инструментов симулятора роботов: запуск миров, паузы, пошаговый режим и отладка.
- 192 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер управляет локальным симулятором по HTTP и может запускать контроллеры робота и программы станков в симуляции.
- Нужен установленный симулятор, который тоже запускает код на вашей машине.
Установка
- Работает в
Ручная установка
{"mcpServers": {"omnisim": {"command": "python", "args": ["-m", "omnisim_mcp"], "env": {"PYTHONPATH": "packages/omnisim-mcp/src", "OMNISIM_HARNESS_URL": "http://127.0.0.1:6789"}}}}Конфигурация из `.mcp.json` репозитория: Claude Code подхватывает ее при открытии каталога проекта, сервер работает без установки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер управляет локальным симулятором по HTTP и может запускать контроллеры робота и программы станков в симуляции.
- Нужен установленный симулятор, который тоже запускает код на вашей машине.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OmniSim — открытая мастерская для робототехники, где агент работает с физическим симулятором. Входящий в репозиторий MCP-сервер `omnisim-mcp` проксирует к нему инструменты World Harness: загрузить мир, запустить, осмотреть и выяснить, что произошло. Claude Code, Claude Desktop, Cursor и другие MCP-клиенты запускают роботов, ставят `sim_pause` и `sim_break` и читают контакты, пределы суставов и события на одной ленте. Инструменты сообщают, когда чего-то не видят: `get_contacts` возвращает полноту данных и причины пустого ответа, а `get_capabilities` перечисляет то, что симулятор отказывается делать. Рядом лежат цифровые двойники ЧПУ, лазера и 3D-принтера и плагин для Codex.
Для кого. Робототехникам и студентам, которые отлаживают роботов в симуляции вместе с агентом и у которых нет доступа к железу.
Подходит, если
- Робот в симуляции ведет себя странно, и нужно поставить точку останова на событии контакта.
- Агент по обычной фразе строит мир и запускает контроллер.
- Нужно понять, какие суставы упираются в пределы и когда.
- Деталь робота делают на цифровом двойнике ЧПУ перед реальным станком.
- Модель проверяют на реалистичном симуляторе, пока железа нет.
Не подходит, если
- Нужен простой сервер для документации: инструменты MCP управляют самим симулятором.
- Компьютер на macOS: проект его не поддерживает.
- Требуется проверка на реальном роботе: автор пока не запускал мост на настоящей плате GRBL.
Пример запроса к агенту
Загрузи мир с манипулятором, поставь паузу на первом контакте и покажи, какие суставы дошли до предела.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
OMNISIM_HARNESS_URL- Адрес harness симулятора, по умолчанию http://127.0.0.1:6789
Ограничения
Сервер лишь прокси: сначала запускается сам симулятор и его harness на порту 6789 командой `python -m omnisim harness`. Готовый пакет есть только для Windows 10 и 11, на Ubuntu 24.04 и 22.04 проект собирается из исходников за 25–45 минут, macOS не поддерживается. В реестре PyPI пакета `omnisim-mcp` сейчас нет, сервер запускается из каталога проекта через `python -m omnisim_mcp`. Обнаружение событий вне паузы идет по такту супервизора и может пропустить событие: сначала `sim_pause`, затем `sim_step`. Для некоторых команд нужен ключ OmniKey.
Как отключить. Удалите запись `omnisim` из конфигурации MCP клиента и остановите harness. Проект удаляется вместе с каталогом установки.
Частые вопросы
Как подключить OmniSim MCP к Claude Code?
Откройте каталог проекта: файл `.mcp.json` в корне сам регистрирует сервер без установки. Перед этим запустите harness командой `python -m omnisim harness`.
Какие клиенты поддерживаются?
Claude Code, Claude Desktop, Cursor и любой клиент MCP. Для Cursor и Claude Desktop есть отдельные фрагменты конфигурации в документации пакета.
Сколько инструментов у сервера?
46. Каждый вызывает один HTTP-запрос к harness симулятора, на котором работает человек.
Как поставить паузу и шагать?
`sim_pause` держит движок между вызовами под арендой, по умолчанию 30 секунд, `sim_step` продвигает симуляцию, а `sim_break` останавливает ее на событии.
Работает ли на macOS?
Нет. Нет пакета и проверенной сборки, физика Newton не проверена. Нужны Windows или Ubuntu 24.04.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для ROS 2: агент смотрит топики, сервисы и действия робота, читает карты и облака точек и при желании управляет им
Скиллы по робототехнике для Claude Code, Codex, Gemini CLI и Cursor: ROS 2, симуляторы, навигация и готовые демо.
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
MCP-сервер для CODESYS V3.5: Claude правит Structured Text, собирает проект настоящим компилятором и гоняет симуляцию.
Прозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
Расширение VS Code для поиска и установки MCP-серверов и скиллов в GitHub Copilot, Claude Code и Codex CLI
Коротко о README
Репозиторий описывает симулятор целиком: физику, цифровых двойников станков, сборку робота из концепт-эскиза и сравнение с другими симуляторами. MCP-сервер вынесен в отдельный пакет, который лишь передает вызовы агента в harness.