ROS MCP Server
Servidor MCP de robotmcp
Conecta LLM a robots ROS y ROS 2 para trabajar con topics, servicios, acciones y parámetros mediante rosbridge.
Instalar ROS MCP Server
Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:
Requiere uv (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.
Compartir este servidor
El enlace abre esta página, con el comando de instalación y los pasos de configuración.
mcp.tc/i/rosDescripción
ROS MCP Server permite que un asistente de IA controle y observe robots que ejecutan ROS 1 o ROS 2. Puede publicar y suscribirse a topics, llamar a servicios y acciones, establecer parámetros, leer datos de sensores y monitorizar el estado del robot. Ayuda al modelo a descubrir los topics, servicios y acciones disponibles, incluidos los tipos personalizados, y a usarlos con la sintaxis correcta.
Se ejecuta localmente mediante stdio como el paquete de PyPI ros-mcp, iniciado con uvx. Se comunica con el robot a través de un nodo WebSocket de rosbridge, por lo que no hace falta modificar el código existente del robot. No se requiere iniciar sesión ni clave de API. Funciona con clientes MCP como Claude Code, Claude Desktop, Cursor, Codex CLI y Gemini CLI.
Qué puedes hacer
- Publicar y suscribirse a topics de ROS
- Llamar a servicios y acciones de ROS
- Leer y establecer parámetros del robot
- Leer datos de sensores y monitorizar el estado del robot
- Descubrir topics, servicios y tipos de mensaje personalizados
- Funciona con distribuciones de ROS 1 y ROS 2
Herramientas
Los servidores locales muestran sus herramientas cuando están en marcha, y este no publica su lista por adelantado. Tu cliente las muestra después de añadirlo.
Prompts de ejemplo
Lista todos los topics disponibles en mi robot y muestra sus tipos de mensaje.
Suscríbete al topic del lidar y dime si hay algo cerca del robot.
Llama al servicio de la pinza y comprueba si el efector final responde correctamente.
Lee los parámetros de navegación actuales y resúmelos.
Configuración
Todos los clientes inician ROS MCP Server en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.
Claude Code
- Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport stdio ros -- uvx ros-mcp --transport=stdio- Inicia Claude Code y escribe
/mcp. ros debería aparecer como conectado.
Añade --scope user para que esté disponible en todos los proyectos.
Claude Desktop
- Abre Settings → Developer → Edit Config. Se abre
claude_desktop_config.json. Añade:
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}- Guarda el archivo y reinicia Claude Desktop.
Necesita uv (Python) en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.
Cursor
Añadir a Cursor (se abre en una pestaña nueva)
O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}Necesita uv (Python) en tu equipo.
VS Code
Instalar en VS Code (se abre en una pestaña nueva)
O desde un terminal:
code --add-mcp '{"name":"ros","type":"stdio","command":"uvx","args":["ros-mcp","--transport=stdio"]}'O haz commit del archivo en el repositorio como .vscode/mcp.json:
{
"servers": {
"ros": {
"type": "stdio",
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}Necesita uv (Python) en tu equipo.
Devin Desktop
- Añádelo a
~/.config/devin/mcp_config.json(macOS y Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}- Actualiza la lista de servidores MCP en Cascade.
Devin Desktop es el nuevo nombre de Windsurf.
Codex
codex mcp add ros -- uvx ros-mcp --transport=stdioO edita directamente ~/.codex/config.toml:
[mcp_servers.ros]
command = "uvx"
args = ["ros-mcp", "--transport=stdio"]Necesita uv (Python) en tu equipo.
Gemini CLI
gemini mcp add ros uvx -- ros-mcp --transport=stdioAsí lo añades al proyecto actual. Añade -s user para usarlo en todas partes.
Cualquier cliente
La mayoría de los clientes que inician servidores locales aceptan esta forma:
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}Zed pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.
Necesita uv (Python) en tu equipo.
Insertar
Muestra ROS MCP Server en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones
La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.
Insignia para README
[](https://mcp.tc/i/ros)<a href="https://mcp.tc/i/ros"><img src="https://mcp.tc/i/ros/badge.svg" alt="ROS MCP Server on mcp.tc" height="20"></a>Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.
Tarjeta para web
<script src="https://mcp.tc/w/ros.js" async></script>La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.
iframe
<iframe src="https://mcp.tc/embed/ros" title="ROS MCP Server on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.
JSON
La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).
https://mcp.tc/i/ros.jsonPrompt para la IA
Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de ROS MCP Server a tu web.
Añade a mi web la tarjeta de mcp.tc de ROS MCP Server, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.
Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:
```html
<script src="https://mcp.tc/w/ros.js" async></script>
```
Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.
```html
<div data-mcptc="ros"><a href="https://mcp.tc/i/ros">ROS MCP Server on mcp.tc</a></div>
```
Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.
Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).
Para un README u otra documentación en Markdown, usa la insignia:
```markdown
[](https://mcp.tc/i/ros)
```
Referencia: https://mcp.tc/es/embedHistorial de cambios
Este servidor se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: cada versión nueva aparece aquí, junto con las ediciones de su responsable.
Preguntas frecuentes
¿Puedo pegar mcp.tc/i/ros en mi cliente MCP?
No. ROS MCP Server se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es uvx ros-mcp --transport=stdio.
¿ROS MCP Server necesita una clave de API?
No. No declara claves ni variables de entorno. Se ejecuta con los permisos de tu cuenta de usuario, así que comprueba a qué pueden acceder sus herramientas.
¿ROS MCP Server es un servidor remoto o local?
Local. Tu cliente lo inicia como un proceso en tu equipo con uvx ros-mcp --transport=stdio, que necesita uv (Python).
¿Qué puede hacer ROS MCP Server?
Puedes publicar y suscribirse a topics de ROS, llamar a servicios y acciones de ROS y leer y establecer parámetros del robot.
¿Qué clientes pueden usarlo?
Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.
¿mcp.tc sigue los cambios de ROS MCP Server?
En parte. Se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: su pestaña Historial muestra cada versión nueva y las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.
¿Quién escribió esta página?
El robot de mcp.tc leyó los metadatos públicos de ROS MCP Server (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.
mcp.tc no tiene relación con robotmcp. Esta página se creó a partir de los metadatos públicos de ROS MCP Server, comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.