ROS MCP Server
Serveur MCP par robotmcp
Connecter des LLM à des robots ROS et ROS 2 pour utiliser topics, services, actions et paramètres via rosbridge.
Installer ROS MCP Server
Tourne sur votre machine. Votre client le lance avec cette commande :
Nécessite uv (Python) sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.
Partager ce serveur
Ouvre cette page, avec la commande d’installation et les étapes de configuration.
mcp.tc/i/rosPrésentation
ROS MCP Server permet à un assistant IA de contrôler et d’observer des robots sous ROS 1 ou ROS 2. Il peut publier et s’abonner à des topics, appeler des services et des actions, définir des paramètres, lire les données des capteurs et surveiller l’état du robot. Il aide le modèle à découvrir les topics, services et actions disponibles, y compris les types personnalisés, et à les utiliser avec la bonne syntaxe.
Il s’exécute en local via stdio sous forme du paquet PyPI ros-mcp, lancé avec uvx. Il communique avec le robot via un nœud WebSocket rosbridge, ce qui évite de modifier le code existant du robot. Aucun compte ni clé API n’est requis. Il fonctionne avec des clients MCP tels que Claude Code, Claude Desktop, Cursor, Codex CLI et Gemini CLI.
Ce que vous pouvez faire
- Publier et s’abonner à des topics ROS
- Appeler des services et des actions ROS
- Lire et définir les paramètres du robot
- Lire les données des capteurs et surveiller l’état du robot
- Découvrir les topics, services et types de messages personnalisés
- Compatible avec les distributions ROS 1 et ROS 2
Outils
Les serveurs locaux présentent leurs outils une fois lancés, et celui-ci ne publie pas sa liste à l’avance. Votre client les affiche après l’ajout.
Exemples de prompts
Liste tous les topics disponibles sur mon robot et montre leurs types de messages.
Abonne-toi au topic du lidar et dis-moi si quelque chose est proche du robot.
Appelle le service de la pince et vérifie si l’effecteur répond correctement.
Lis les paramètres de navigation actuels et résume-les.
Configuration
Chaque client lance ROS MCP Server sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.
Claude Code
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio ros -- uvx ros-mcp --transport=stdio- Démarrez Claude Code et tapez
/mcp. ros devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop.
Nécessite uv (Python) sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
Cursor
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}Nécessite uv (Python) sur votre ordinateur.
VS Code
Installer dans VS Code (s’ouvre dans un nouvel onglet)
Ou depuis un terminal :
code --add-mcp '{"name":"ros","type":"stdio","command":"uvx","args":["ros-mcp","--transport=stdio"]}'Ou committez-le dans le dépôt, dans .vscode/mcp.json :
{
"servers": {
"ros": {
"type": "stdio",
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}Nécessite uv (Python) sur votre ordinateur.
Devin Desktop
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}- Actualisez la liste des serveurs MCP dans Cascade.
Devin Desktop est le nouveau nom de Windsurf.
Codex
codex mcp add ros -- uvx ros-mcp --transport=stdioOu modifiez directement ~/.codex/config.toml :
[mcp_servers.ros]
command = "uvx"
args = ["ros-mcp", "--transport=stdio"]Nécessite uv (Python) sur votre ordinateur.
Gemini CLI
gemini mcp add ros uvx -- ros-mcp --transport=stdioCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout client
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"mcpServers": {
"ros": {
"command": "uvx",
"args": [
"ros-mcp",
"--transport=stdio"
]
}
}
}Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite uv (Python) sur votre ordinateur.
Intégrer
Affichez ROS MCP Server dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations
La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.
Badge pour 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>Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.
Carte pour site web
<script src="https://mcp.tc/w/ros.js" async></script>La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.
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>Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.
JSON
La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).
https://mcp.tc/i/ros.jsonPrompt pour l’IA
Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de ROS MCP Server à votre site.
Ajoute à mon site la carte mcp.tc de ROS MCP Server, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.
Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :
```html
<script src="https://mcp.tc/w/ros.js" async></script>
```
Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.
```html
<div data-mcptc="ros"><a href="https://mcp.tc/i/ros">ROS MCP Server on mcp.tc</a></div>
```
Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.
Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).
Pour un README ou une autre doc en Markdown, utilise plutôt le badge :
```markdown
[](https://mcp.tc/i/ros)
```
Référence : https://mcp.tc/fr/embedHistorique des changements
Ce serveur tourne sur votre ordinateur, donc nous suivons son paquet PyPI : chaque nouvelle version apparaît ici, avec les modifications de son propriétaire.
FAQ
Puis-je coller mcp.tc/i/ros dans mon client MCP ?
Non. ROS MCP Server tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est uvx ros-mcp --transport=stdio.
ROS MCP Server a-t-il besoin d’une clé API ?
Non. Il ne déclare ni clé ni variable d’environnement. Il s’exécute avec les droits de votre compte utilisateur, vérifiez donc ce que ses outils peuvent atteindre.
ROS MCP Server est-il un serveur distant ou local ?
Local. Votre client le lance comme un processus sur votre ordinateur avec uvx ros-mcp --transport=stdio, qui nécessite uv (Python).
Que peut faire ROS MCP Server ?
Vous pouvez publier et s’abonner à des topics ROS, appeler des services et des actions ROS et lire et définir les paramètres du robot.
Quels clients peuvent l’utiliser ?
Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.
mcp.tc suit-il les changements de ROS MCP Server ?
En partie. Il tourne sur votre ordinateur, donc nous suivons son paquet PyPI : son onglet Historique montre chaque nouvelle version et les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.
Qui a rédigé cette page ?
Le robot de mcp.tc a lu les métadonnées publiques de ROS MCP Server (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.
mcp.tc n’est pas affilié à robotmcp. Cette page a été construite à partir des métadonnées publiques de ROS MCP Server, vérifiées pour la dernière fois le 3 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.