# MCP Server Commands

> MCP Server Commands is an open-source MCP server for developer tools. MCP server that lets AI clients run shell commands and scripts on the local machine. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, vscode, Linux, macOS, Windows, self-hosted
- **Repository:** https://github.com/bytedance/ui-tars-desktop/tree/HEAD/packages/agent-infra/mcp-servers/commands
- **MCP Registry name:** io.github.bytedance/mcp-server-commands
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-18

## About

The README describes an MCP server that gives AI clients the ability to execute arbitrary commands on the host it runs on. It is published on npm as @agent-infra/mcp-server-commands and can be launched on demand by an MCP client over stdio, or started with a port flag to serve Streamable HTTP and SSE endpoints.

The server can be pointed at a working directory with a --cwd option, which the sample configuration sets to /tmp. The README also shows a run_script tool that takes an interpreter name and script text, with node used in its example, so a client can run short scripts rather than only single shell commands.

It suits developers who already use an MCP-capable editor or assistant such as VS Code, Cursor, Windsurf or Claude Desktop and want the model to run local commands as part of a coding or automation session. Because it executes arbitrary commands, the README's examples are the main guide to how it is intended to be scoped.

## Features

- **Stdio and remote transports:** Runs as a local stdio process or as a server exposing Streamable HTTP and SSE endpoints on a chosen port.
- **Script execution tool:** Exposes a run_script tool that accepts an interpreter and script body, as shown in the README's in-memory example.
- **Working directory option:** A --cwd flag sets the directory where commands start, as in the sample configuration using /tmp.
- **In-process usage:** A createServer export lets JavaScript and TypeScript clients connect without a separate command-line process.
- **Editor client setup:** The README gives install steps and configuration snippets for VS Code, Cursor, Windsurf and Claude Desktop.

## Good for

- Letting an AI coding assistant run build or test commands in a local project
- Running short Node.js scripts generated by a model during an automation session
- Serving command execution to a remote MCP client over a local HTTP endpoint
- Embedding command execution inside a JavaScript or TypeScript MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-commands -- npx -y @agent-infra/mcp-server-commands
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

```json
{
  "servers": {
    "mcp-server-commands": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands"
      ]
    }
  }
}
```

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

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

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

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

## Tools

- `run_script`: Runs a script using a given interpreter, as shown in the README example.

## FAQ

### Which transports does it support?

The registry entry and README list stdio, SSE and Streamable HTTP. The README recommends Streamable HTTP for remote use.

### What does it need to run?

The README lists Node.js 18 or newer and an MCP client such as VS Code, Cursor, Windsurf or Claude Desktop.

### Which tool does it expose?

The README's in-memory example calls a tool named run_script, taking an interpreter and a script string.

### Is MCP Server Commands free?

Yes. MCP Server Commands is open source, so you can use and self-host it for free.

### How do I add MCP Server Commands to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-commands -- npx -y @agent-infra/mcp-server-commands

### What are the best alternatives to MCP Server Commands?

The closest alternatives to MCP Server Commands are MCP Server Filesystem, Filesystem, MCP Ts Template, Makefile MCP and MCP Server.

## Where this comes from

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

## Alternatives

- [MCP Server Filesystem](https://ai-powered.com/mcp/mcp-server-filesystem): MCP Server Filesystem is an open-source MCP server for files and documents.
- [Filesystem](https://ai-powered.com/mcp/filesystem): Filesystem is an open-source MCP server for files and documents.
- [MCP Ts Template](https://ai-powered.com/mcp/mcp-ts-template): MCP Ts Template is an open-source MCP server for developer tools.
- [Makefile MCP](https://ai-powered.com/mcp/makefile-mcp-2): Makefile MCP is an open-source MCP server for developer tools.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mweo0sk4): MCP Server is an MCP server for developer tools.
- [Coding Tools MCP](https://ai-powered.com/mcp/coding-tools-mcp): Coding Tools MCP is an open-source MCP server for developer tools.
- [Edit MCP](https://ai-powered.com/mcp/edit-mcp): Edit MCP is an open-source MCP server for developer tools.
- [MCP Server Template](https://ai-powered.com/mcp/mcp-server-template): MCP Server Template is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-server-commands
