# armguard-mcp

> armguard-mcp is an open-source MCP server for engineering simulation. Safety-enforcing MCP server for ROS 2 robot arms with approval prompts and audit log. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, self-hosted
- **Repository:** https://github.com/lynn-hh/armguard-mcp
- **MCP Registry name:** io.github.Lynn-hh/armguard-mcp
- **Categories:** [engineering simulation](https://ai-powered.com/categories/engineering-simulation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The key claim is that limits live on the server, not in the prompt. Every plan is checked against a YAML policy before anything moves: joint limits, a workspace box, keep-out zones, speed and step caps, force thresholds, allowlists and rate limits, with a software e-stop on top. A prompt injection hidden in an image or topic string can change what the model asks for but not what the server allows.

Motion is two-step. plan tools return a preview and a single-use plan_id, and only execute_plan moves the arm. Motion outside the envelope needs a human to approve it through MCP elicitation, and is denied by default when the client cannot ask. All calls, approvals, denials and e-stops go into an append-only JSONL audit log.

It is alpha. The 22 tools run against a simulated Franka FR3, and the ROS 2 backend with MoveIt 2 was tested on Jazzy but not on a physical robot. The README states it is defense in depth, not certified functional safety.

## Features

- **Server-side envelope:** Joint limits, workspace box, keep-out zones, speed, step and force caps.
- **Plan then execute:** Previews return single-use plan ids; only execute_plan moves.
- **Human approval:** Out-of-envelope motion asks via MCP elicitation.
- **Audit log:** Append-only JSONL of calls, approvals and e-stops.
- **Simulated demo:** A bundled FR3 policy runs with one uvx command.
- **Narrow scope:** 22 fixed tools instead of arbitrary ROS access.

## Good for

- Try an LLM controlling a simulated robot arm safely
- Test prompt-injection resistance
- Preview a motion before executing
- Keep an audit trail of agent-driven robot actions

## Install

### Claude Code (Terminal)

```sh
claude mcp add armguard-mcp -- uvx armguard-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "armguard-mcp": {
      "command": "uvx",
      "args": [
        "armguard-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "armguard-mcp": {
      "command": "uvx",
      "args": [
        "armguard-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "armguard-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "armguard-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "armguard-mcp": {
      "command": "uvx",
      "args": [
        "armguard-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "armguard-mcp": {
      "command": "uvx",
      "args": [
        "armguard-mcp"
      ]
    }
  }
}
```

## FAQ

### Has it run on a real robot?

No, the README says it has not been run on a physical robot yet.

### Is it certified safety?

No, it is defense in depth, not certified functional safety.

### Does it need ROS to try?

No, the simulated FR3 starts with uvx armguard-mcp.

### How does it differ from generic ROS bridges?

It exposes 22 fixed skill-level tools and blocks arbitrary publish or service calls.

### Is armguard-mcp free?

Yes. armguard-mcp is open source, so you can use and self-host it for free.

### How do I add armguard-mcp to Claude Code?

Run this command in your terminal: claude mcp add armguard-mcp -- uvx armguard-mcp

### What are the best alternatives to armguard-mcp?

The closest alternatives to armguard-mcp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/armguard-mcp
