RR

robotmcp/ros-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1.5천 stars 220 forks 품질 64 트렌드 45Apache-2.0

Claude와 GPT와 같은 AI 모델을 MCP와 ROS를 이용한 로봇과 연결하세요.

개요

ROS-MCP-Server는 Claude, GPT, Gemini와 같은 대형 언어 모델과 로봇을 연결하여 기존 로봇 소스 코드를 변경하지 않고 양방향 통신을 가능하게 합니다. - → 기존 ROS 설정에 로스브리지 노드를 추가하면 됩니다. - → LLM은 로봇을 제어하고 로봇에서 일어나는 모든 일을 관찰할 수 있습니다. - → 주제 게시 및 구독, 서비스 및 액션 호출, 매개변수 설정, 센서 데이터 읽기, 로봇 상태 실시간 모니터링 기능 - → LLM이 사용 가능한 주제, 서비스, 액션 및 그 유형(커스텀 포함)을 발견하도록 안내하며, 수동 설정 없이도 올바른 문법으로 사용할 수 있게 합니다. - → 오픈 MCP 표준을 기반으로 구축되어 Claude Code, Codex CLI, Gemini CLI, Claude Desktop, ChatGPT, Cursor 등 다양한 기능을 지원합니다. - → ROS 2(Jazzy, Humble 등)와 ROS 1 배포판 간 호환성. 🏭 (영상) - MCP 서버는 클로드를 생산 산업용 로봇에 연결하며, 참고 자료는 기술자 매뉴얼뿐입니다.

개요(AI 번역)

ROS-MCP-Server는 Claude, GPT, Gemini와 같은 대형 언어 모델과 로봇을 연결하여 기존 로봇 소스 코드를 변경하지 않고 양방향 통신을 가능하게 합니다.

왜 ROS-MCP인가요?

  • 로봇 소스 코드 변경은 필요 없어요 → 기존 ROS 설정에 rosbridge 노드만 추가하면 됩니다.
  • 진정한 양방향 통신 → LLM은 로봇을 제어할 수 있고 로봇에서 일어나는 모든 것을 관찰할 수 있습니다.
  • 전체 맥락 → 주제 게시 및 구독, 서비스 및 액션 호출, 매개변수 설정, 센서 데이터 읽기, 로봇 상태 실시간 모니터링.
  • 깊은 ROS 이해 → LLM이 사용 가능한 주제, 서비스, 액션, 그리고 그 유형(사용자 지정 포함)을 발견하도록 안내하며, 수동 설정 없이도 올바른 문법으로 사용할 수 있게 합니다.
  • 오픈 MCP 표준을 기반으로 구축된 모든 MCP 클라이언트와 호환되며→ Claude Code, Codex CLI, Gemini CLI, Claude Desktop, ChatGPT, Cursor 등을 지원합니다.
  • **ROS 버전 전반에 걸쳐 작동→ ROS 2(Jazzy, Humble 등)와 ROS 1 배포판 간 호환.

🎥 실제 사례


🏭 예시 - 산업용 로봇 엔드 이펙터의 AI 에이전트 진단 (영상)

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

ROS MCP Server 🧠⇄🤖

ROS-MCP-Server connects large language models (such as Claude, GPT, and Gemini) to robots, enabling bidirectional communication with no changes to existing robot source code.

Why ROS-MCP?

  • No robot source code changes → just add the rosbridge node to your existing ROS setup.
  • True two-way communication → LLMs can both control robots and observe everything happening on the Robot.
  • Full context → publish & subscribe to topics, call services & actions, set parameters, read sensor data, and monitor robot state in real time.
  • Deep ROS understanding → guides the LLM to discover available topics, services, actions, and their types (including custom ones) — enabling it to use them with the right syntax without manual configuration.
  • Works with any MCP client → built on the open MCP standard, supporting Claude Code, Codex CLI, Gemini CLI, Claude Desktop, ChatGPT, Cursor, and more.
  • Works across ROS versions → compatible across ROS 2 (Jazzy, Humble, and others) and ROS 1 distros.

🎥 Examples in Action


🏭 Example - AI Agent diagnosis of Industrial Robot End Effector (Video)

  • The MCP server connects Claude to a production industrial robot, with only the technician manuals as reference.
  • Claude discovers the robot’s custom topic and service types and their syntax on its own.
  • From a single prompt to test the gripper, it reads the manuals, runs its own tests, finds an anomaly, and reports the root cause.

🤖 Example - Controlling “Wilson” with natural language (video)

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →