mcpField
M
mcp-tmux

mcp-tmux

Local
github.com/k8ika0sDeveloper Tools
Repository

About mcp-tmux

Model Context Protocol server that lets LLMs collaboratively drive tmux

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "k8ika0s-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>"
      }
    }
  }
}
Run commandnpx -y @k8ika0s/mcp-tmux
Environment variables to set
MCP_TMUX_HOSTOptional default SSH host alias to use when none is provided.
MCP_TMUX_SESSIONOptional default tmux session name to use when none is provided.
TMUX_BINOptional path to tmux binary if not on PATH.
MCP_TMUX_TIMEOUT_MSTimeout in milliseconds for tmux/ssh invocations (default 15000).
MCP_TMUX_LOG_DIROverride log directory (defaults to ~/.config/mcp-tmux/logs).
MCP_TMUX_HOSTS_FILEOptional JSON file for per-host tmux PATH/bin overrides.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@k8ika0s/mcp-tmux0.1.7

Tools

39

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
hoststringNoSSH host alias to remember.
panestringNoPane target to remember.
windowstringNoWindow target to remember.
sessionstringNoSession name to remember.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.