mcp-tmux

Name: mcp-tmux
Author: k8ika0s

本地服务

github.com/k8ika0s开发工具

代码仓库

关于 mcp-tmux

让 LLM 与用户协作操控 tmux 的 Model Context Protocol 服务

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "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>"
      }
    }
  }
}

启动命令npx -y @k8ika0s/mcp-tmux

需要配置的环境变量

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.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@k8ika0s/mcp-tmux0.1.7stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
host	string	否	要记住的 SSH 主机别名。
pane	string	否	要记住的窗格目标。
window	string	否	要记住的窗口目标。
session	string	否	要记住的会话名称。