ROS MCP Server

Установка

npx skillfoxx add mcp/ros-mcp-server

claude mcp add --transport stdio ros-mcp-server -- uvx ros-mcp==3.1.2

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

code --add-mcp '{"name":"ros-mcp-server","type":"stdio","command":"uvx","args":["ros-mcp==3.1.2"]}'

{
  "servers": {
    "ros-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

codex mcp add ros-mcp-server -- uvx ros-mcp==3.1.2

[mcp_servers.ros-mcp-server]
command = "uvx"
args = ["ros-mcp==3.1.2"]

gemini mcp add -s user ros-mcp-server uvx ros-mcp==3.1.2

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcp": {
    "ros-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "context_servers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

claude mcp add ros-mcp -- uvx ros-mcp --transport=stdio

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

Что делает

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

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

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

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

Ограничения

На машине робота должен быть установлен 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.

MCP

Транспорт

stdio, http

Авторизация

не нужна

Проверка безопасности

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

Коротко о README

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

Похожие