← Index

io.github.k8ika0s/mcp-tmux

io.github.k8ika0s/mcp-tmux·v0.1.7·Cloud Storage
Quality Score
72
/100

Model Context Protocol server that lets LLMs collaboratively drive tmux

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "<mcp_tmux_host>",
        "MCP_TMUX_SESSION": "<mcp_tmux_session>",
        "TMUX_BIN": "<tmux_bin>",
        "MCP_TMUX_TIMEOUT_MS": "<mcp_tmux_timeout_ms>",
        "MCP_TMUX_LOG_DIR": "<mcp_tmux_log_dir>",
        "MCP_TMUX_HOSTS_FILE": "<mcp_tmux_hosts_file>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "<mcp_tmux_host>",
        "MCP_TMUX_SESSION": "<mcp_tmux_session>",
        "TMUX_BIN": "<tmux_bin>",
        "MCP_TMUX_TIMEOUT_MS": "<mcp_tmux_timeout_ms>",
        "MCP_TMUX_LOG_DIR": "<mcp_tmux_log_dir>",
        "MCP_TMUX_HOSTS_FILE": "<mcp_tmux_hosts_file>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @k8ika0s/mcp-tmux
§02  Environment variables
MCP_TMUX_HOST

Optional default SSH host alias to use when none is provided.

MCP_TMUX_SESSION

Optional default tmux session name to use when none is provided.

TMUX_BIN

Optional path to tmux binary if not on PATH.

MCP_TMUX_TIMEOUT_MS

Timeout in milliseconds for tmux/ssh invocations (default 15000).

MCP_TMUX_LOG_DIR

Override log directory (defaults to ~/.config/mcp-tmux/logs).

MCP_TMUX_HOSTS_FILE

Optional JSON file for per-host tmux PATH/bin overrides.

§03  MCP Quality Score  ·  methodology
freshness
17
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Cloud Storage