Skip to content
MCP server

MCP Server Commands

MCP server that lets AI clients run shell commands and scripts on the local machine

Install
Pricing
Open source
Platforms
CLI, API, vscode
Runs
Remotely or Locally
Version
1.0.0
Listing updated
today

Similar MCP servers

About MCP Server Commands

MCP Server Commands is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free, distributed as an npm package and part of the open-source ui-tars-desktop repository.

MCP Server Commands 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.

How AIPoweredBot checks servers