# UI-TARS Commands MCP

> ByteDance's local MCP server that lets your agent run any shell command or script on your machine, with your own permissions.

ByteDance's Commands MCP server, from its UI-TARS Desktop repository and published on npm as @agent-infra/mcp-server-commands. It gives your agent a shell: it runs a command or script on the machine where the server runs and sends back the output. ByteDance adapted it from g0t4's mcp-server-commands.

What you can do with it
- Run a command with its arguments, such as git status or ls -la, and get back what it printed and any errors (run_command)
- Pipe a script to an interpreter such as bash, zsh, fish, python or node and get its output (run_script)
- Choose the working directory for each call, or set a default with --cwd
- Use its run_command prompt to put a command's output into your conversation, where you pick the command rather than the agent

How it connects
It runs on your machine with npx @agent-infra/mcp-server-commands@latest and needs Node.js 18 or newer. ByteDance documents setup for VS Code with GitHub Copilot, Cursor, Windsurf and Claude Desktop. Start it with --port to serve it over Streamable HTTP (/mcp) or SSE (/sse) on 127.0.0.1 instead of stdio.

The risk
- It runs whatever command or script your agent sends, as your user account: it can read, change and delete your files, install software and reach the network.
- There's no allowlist, sandbox or read-only mode. --cwd only sets where commands start; it doesn't keep them inside that folder.
- Your agent's tool approval is the only check, so read each command before you allow it.
- It listens on 127.0.0.1 by default. Setting --host 0.0.0.0 lets anyone who can reach that port on your network run commands on your machine.

- Type: Plugin
- Made by: bytedance
- Category: AI & agents
- Formats: Local MCP
- Version: 1.0.0
- Website: https://github.com/bytedance/UI-TARS-desktop/tree/main/packages/agent-infra/mcp-servers/commands
- Source: https://github.com/bytedance/ui-tars-desktop/tree/HEAD/packages/agent-infra/mcp-servers/commands
- Page: https://pluginboard.ai/plugins/ui-tars-commands-mcp

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "ui-tars-commands-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22ui-tars-commands-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40agent-infra%2Fmcp-server-commands%40latest%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"ui-tars-commands-mcp","command":"npx","args":["-y","@agent-infra/mcp-server-commands@latest"]}'
```

Copilot CLI:

```shell
copilot mcp add ui-tars-commands-mcp -- npx -y @agent-infra/mcp-server-commands@latest
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=ui-tars-commands-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhZ2VudC1pbmZyYS9tY3Atc2VydmVyLWNvbW1hbmRzQGxhdGVzdCJdfQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "ui-tars-commands-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add ui-tars-commands-mcp -- npx -y @agent-infra/mcp-server-commands@latest
```

### Codex

Run in your terminal:

```shell
codex mcp add ui-tars-commands-mcp -- npx -y @agent-infra/mcp-server-commands@latest
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "ui-tars-commands-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add ui-tars-commands-mcp npx -y @agent-infra/mcp-server-commands@latest
```

### OpenClaw

In a terminal: Run openclaw mcp add ui-tars-commands-mcp --command npx, with --arg before each argument (-y @agent-infra/mcp-server-commands@latest) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add ui-tars-commands-mcp -- npx -y @agent-infra/mcp-server-commands@latest
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "ui-tars-commands-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).