Terminal MCP

A secure Model Context Protocol (MCP) server providing controlled terminal access for AI assistants such as:

• LM Studio

• Claude Desktop

• Cursor

• Windsurf

• Continue

• Any MCP-compatible client

Features

• Execute whitelisted commands

• Configurable working directory

• Configurable timeout

• Output size limit

• Windows support

• Linux support

• Asynchronous execution

• MCP compliant

Related MCP server: cmd-line-mcp

Installation

Requirements

• Python 3.11+

• pip

Install:

pip install .

or

pip install -e .

Running

terminal-mcp

or

py -m terminal_mcp.server

Example MCP configuration

{
    "mcpServers": {
        "terminal": {
            "command": "terminal-mcp"
        }
    }
}

Example prompt

Run pytest.

or

Build the project.

or

Run black on the repository.

Security

The server intentionally restricts what can be executed.

Allowed commands are configurable.

Commands outside the whitelist are rejected.

Timeouts prevent hanging processes.

Output is truncated after a configurable limit.

License

MIT