Keyflow
Contact

Search Keyflow

Find a shortcut, workflow, MCP server or skill

terminal-mcp

local MCP server

terminal-mcp is a local MCP server: MCP server for interactive terminal sessions — SSH, REPLs, database CLIs, TUI apps. Install it from pypi as terminal-mcp.

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.

What you need

  • Runtime: Python with uv (runs with uvx).
  • MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
  • Environment variables: TERMINAL_MCP_MAX_SESSIONS, TERMINAL_MCP_IDLE_TIMEOUT

Summary

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

terminal-mcp vs similar servers

ServerStarsTypeAPI keyRuntime
terminal-mcp12LocalYespypi
DBHub3,574LocalYesnpm
smart-terminal12LocalNonpm
Desktop Commander9,802LocalNonpm
LINQ to DB3,329LocalNonuget

Questions

It reads 2 environment variables: TERMINAL_MCP_MAX_SESSIONS, TERMINAL_MCP_IDLE_TIMEOUT. Set them in your MCP config before starting the server.

Python with uv (runs with uvx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.

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
  1. DBHubio.github.bytebase/dbhub3,574
  2. smart-terminalio.github.pungggi/smart-terminal12
  3. Desktop Commanderio.github.wonderwhy-er/desktop-commander9,802
  4. LINQ to DBio.github.linq2db/linq2db.cli3,329
  5. ArcadeDB MCP Servercom.arcadedb/mcp-server1,165
  6. ArcadeDBio.github.ArcadeData/arcadedb1,165
  7. token-saviorio.github.Mibayy/token-savior1,157
  8. mcp-neo4j-aura-managerio.github.neo4j-contrib/mcp-neo4j-aura-manager985