MCP Server Commands
MCP server that lets AI clients run shell commands and scripts on the local machine
- 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-commandsAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server-commands": {
"command": "npx",
"args": [
"-y",
"@agent-infra/mcp-server-commands"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server-commands": {
"command": "npx",
"args": [
"-y",
"@agent-infra/mcp-server-commands"
]
}
}
}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.