# Robotmcp Client

> Connect AI models like Claude & GPT with robots using MCP and ROS.

- **Type:** MCP server
- **Install:** `agentstack add mcp-robotmcp-robotmcp-client`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [robotmcp](https://agentstack.voostack.com/s/robotmcp)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [robotmcp](https://github.com/robotmcp)
- **Source:** https://github.com/robotmcp/robotmcp_client
- **Website:** https://github.com/robotmcp/ros-mcp-server

## Install

```sh
agentstack add mcp-robotmcp-robotmcp-client
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ROS MCP Client 🧠⇄🤖







  


The **ROS MCP Client** is a reference implementation of a Model Context Protocol (MCP) client, designed to connect directly with [ros-mcp-server](https://github.com/robotmcp/ros-mcp-server/).

Instead of using a Desktop LLM client, it acts as a bridge that integrates an LLM, enabling natural-language interaction with any ROS or ROS2 robot.

## 🧠 What It Does

`ros-mcp-client` implements the LLM-side of the MCP protocol.

It can:
- Connect to a `ros-mcp-server` over MCP (stdio or HTTP).
- Send natural language queries or structured requests to the robot without the need to integrate it with a Desktop LLM client
- Stream back feedback, sensor data, or responses from the server.
- Integrate with a local LLM (Gemini, Ollama, Nvidia NeMo).

In short, it lets you run an MCP-compatible client that speaks to robots via the MCP interface — useful for testing, local reasoning, or autonomous AI controllers.

---

## ⚙️ Key Features of the ROS MCP Client

- Implements MCP client specification — plug-and-play with the ROS MCP server.

- ROS-aware LLM interface — specialized prompts and handlers for robotics tasks.

- Supports bidirectional streaming — send commands, receive real-time topic feedback.

- LLM integration ready — use Gemini, Anthropic, or Ollama APIs as reasoning engines.

- Offline-capable — works entirely within local or LAN environments.

---

## 

## 🛠 Getting Started  

The MCP client is version-agnostic (ROS1 or ROS2).  


  
  

### Prerequisites

- ROS or ROS2 running with `rosbridge`
- Active [`ros-mcp-server`](https://github.com/robotmcp/ros-mcp-server) instance

### Installation  

1. Clone the repository  
```bash
git clone https://github.com/robotmcp/ros-mcp-client.git
cd ros-mcp-client
```

2. Install dependencies
```bash
uv sync  # or pip install -e .
```

3. Follow the setup guide for the Gemini Live client:
   - **[Gemini Live Client](clients/gemini_live/README.md)** - Google Gemini integration

4. Start `rosbridge` on the target robot
```bash
ros2 launch rosbridge_server rosbridge_websocket_launch.xml
```  

---

## 📁 Project Structure

```
ros-mcp-client/
├── clients/
│   ├── gemini_live/          # Full-featured Gemini client
│   │   ├── gemini_client.py  # Main client script
│   │   ├── mcp.json          # MCP server configuration
│   │   ├── setup_gemini_client.sh  # Automated setup
│   │   └── README.md         # Detailed setup guide
├── config/                   # Shared configuration
├── scripts/                  # Utility scripts
├── pyproject.toml           # Python dependencies
└── README.md               # This file
```

---

## 📚 Available Clients  

The project includes a comprehensive LLM client implementation:

### 🤖 **Gemini Live Client** (`clients/gemini_live/`)
- **Full-featured** Google Gemini integration
- **Text-only mode** optimized for WSL
- **Real-time interaction** with ROS robots
- **Automated setup** with `setup_gemini_client.sh`

### 🚀 **Quick Start**
```bash
# Try the Gemini Live client
cd clients/gemini_live
./setup_gemini_client.sh
uv run gemini_client.py
```

We welcome community PRs with new client implementations and integrations!  

---

## 🤝 Contributing  

We love contributions of all kinds:  
- Bug fixes and documentation updates  
- New features (e.g., Action support, permissions)  
- Additional examples and tutorials  

Check out the [contributing guidelines](docs/contributing.md) and see issues tagged **good first issue** to get started.  

---

## 📜 License  


This project is licensed under the [Apache License 2.0](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [robotmcp](https://github.com/robotmcp)
- **Source:** [robotmcp/robotmcp_client](https://github.com/robotmcp/robotmcp_client)
- **License:** Apache-2.0
- **Homepage:** https://github.com/robotmcp/ros-mcp-server

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-robotmcp-robotmcp-client
- Seller: https://agentstack.voostack.com/s/robotmcp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.