Shell Server

A simple MCP server that exposes a terminal tool, allowing AI agents to execute shell commands.

Requirements

• Python 3.10+

• uv

Related MCP server: MCP Shell Server

Setup

uv venv
uv sync

Running

uv run server.py

Or during development with the MCP inspector:

uv run mcp dev server.py

Tool

terminal

Executes a shell command and returns its output.

Input

Output

{
  "stdout": "...",
  "stderr": "...",
  "return_code": 0
}

Connecting to Cursor

Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/sami/Documents/MCP/mcp-servers/shellserver",
        "run",
        "server.py"
      ]
    }
  }
}

Then restart Cursor. The terminal tool will be available to the Agent.

Security

This server executes arbitrary shell commands. Only run it locally and never expose it over a network.