ROS MCP Server

MCP-сервер, который соединяет агента с роботом на ROS через rosbridge: чтение датчиков и управление без правок в коде робота

  • 1 525 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-сервер

Широкий доступ

Почему такой уровень

  • Управляет реальным роботом: публикует в топики, вызывает сервисы и действия, задает параметры
  • Ошибочная команда может привести к нежелательному движению механизмов
Все причины и проверки

robotmcp/ros-mcp-server

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/ros-mcp-server

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Управляет реальным роботом: публикует в топики, вызывает сервисы и действия, задает параметры
  • Ошибочная команда может привести к нежелательному движению механизмов

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает агенту двусторонний доступ к роботу под управлением ROS через узел rosbridge, при этом исходный код робота менять не нужно. Агент может публиковать и подписываться на топики, вызывать сервисы и действия, задавать параметры, читать данные датчиков и следить за состоянием робота в реальном времени. Сервер помогает модели обнаружить доступные топики, сервисы, действия и их типы, включая пользовательские, чтобы обращаться к ним с правильным синтаксисом без ручной настройки. Он работает с ROS 2, например Jazzy и Humble, и с дистрибутивами ROS 1, соединение идет по WebSocket, поэтому агент и робот могут быть на разных машинах в одной сети.

Для кого. Для инженеров-робототехников и разработчиков на ROS, которые хотят управлять роботом и разбирать его состояние через агента.

Подходит, если

  • Нужно управлять роботом на ROS командами на естественном языке
  • Нужно читать топики, датчики и состояние робота вместе с агентом
  • Нужно вызвать сервисы или действия и задать параметры без ручного синтаксиса
  • Нужно диагностировать робота или отладить поведение в симуляции

Не подходит, если

  • На машине робота не установлен ROS и нет возможности запустить rosbridge
  • Задача не связана с ROS и роботами

Пример запроса к агенту

Подключись к роботу на localhost через ros-mcp и покажи, какие топики и сервисы доступны

MCP

Транспорт
stdio, http
Авторизация
не нужна

Ограничения

На машине робота должен быть установлен ROS и запущен rosbridge вместе с rosapi, иначе инструменты интроспекции не работают. Rosbridge запускают через launch-файл, а не через ros2 run, иначе rosapi не поднимается. Для установки сервера нужен Python 3.10 или новее и pip 23.0 или новее. Управление реальным роботом требует осторожности: агент может двигать механизмы и менять параметры. ROS 1 объявлен в конце жизненного цикла.

Как отключить. Выполните claude mcp remove ros-mcp или уберите запись ros-mcp из конфигурации MCP в клиенте. При установке через pip можно удалить пакет ros-mcp.

Частые вопросы

Нужно ли менять код робота?

Нет. Достаточно запустить узел rosbridge в существующей установке ROS, сервер подключается к нему по WebSocket.

Работает ли с ROS 1?

Да, сервер совместим с ROS 2 и дистрибутивами ROS 1, хотя ROS 1 объявлен в конце жизненного цикла.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации

MCP-серверШирокий доступ574Звезды репозитория

MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell

MCP-серверШирокий доступ11,6 тыс.Звезды репозитория

MCP сервер для Home Assistant: агент читает состояние устройств, управляет ими и правит дашборды умного дома

MCP-серверШирокий доступ353Звезды репозитория

MCP-сервер для Home Assistant: агент читает состояние умного дома и управляет устройствами через ваш экземпляр

MCP-серверШирокий доступ7,7 тыс.Звезды репозитория

MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API

MCP-серверШирокий доступ415Звезды репозитория

CLI подключает Claude Code или Codex к роботам и симуляторам через ROS 2: агент пишет программы восприятия и управления.

CLIШирокий доступ62Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
ROS MCP Server (эта карточка)нетне нужна1 525
Bagel — вопросы к данным роботов и дроновдане нужна407MCP-сервер отвечает на вопросы о логах роботов
openreality-mcpдаключ необязателен656MCP-сервер превращает видео с телефона в 3D-сцену
Robotics Agent Skillsнет401десять скиллов по робототехнике

Коротко о README

README описывает сервер, который связывает большие языковые модели с роботами через MCP и ROS без изменения кода робота. Заявлена двусторонняя связь: публикация и подписка на топики, вызов сервисов и действий, работа с параметрами, чтение датчиков и состояния. Сервер помогает модели обнаружить топики, сервисы и их типы, включая пользовательские, и работает с ROS 2 и ROS 1. Приведены примеры с промышленным роботом, мобильным роботом Wilson и квадрупедом Unitree Go2 в NVIDIA Isaac Sim. Установка идет через uvx или pip, на роботе поднимается rosbridge с rosapi. Лицензия Apache 2.0.

Бейдж для README

Сообщить о проблеме