terminal-mcp

local MCP server

Installation

Terminal

claude mcp add terminal-mcp -e TERMINAL_MCP_MAX_SESSIONS=... -e TERMINAL_MCP_IDLE_TIMEOUT=... -- uvx terminal-mcp

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "terminal-mcp": {
      "command": "uvx",
      "args": [
        "terminal-mcp"
      ],
      "env": {
        "TERMINAL_MCP_MAX_SESSIONS": "...",
        "TERMINAL_MCP_IDLE_TIMEOUT": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

MCP server for interactive terminal sessions — SSH, REPLs, database CLIs, TUI apps

Questions

terminal-mcp is a local MCP server distributed as the pypi package terminal-mcp.

Run: claude mcp add terminal-mcp -e TERMINAL_MCP_MAX_SESSIONS=... -e TERMINAL_MCP_IDLE_TIMEOUT=... -- uvx terminal-mcp

Run: codex mcp add terminal-mcp --env TERMINAL_MCP_MAX_SESSIONS=... --env TERMINAL_MCP_IDLE_TIMEOUT=... -- uvx terminal-mcp

Similar MCP servers

NameStars

interactive-terminalio.github.amol21p/interactive-terminal18
DBHubio.github.bytebase/dbhub3,574
openroad-mcpio.github.The-OpenROAD-Project/openroad-mcp21
openroad-mcpio.github.luarss/openroad-mcp21
pty-mcpio.github.raychao-oao/pty-mcp16
smart-terminalio.github.pungggi/smart-terminal12
Desktop Commanderio.github.wonderwhy-er/desktop-commander9,802
LINQ to DBio.github.linq2db/linq2db.cli3,329