Tmux MCP Server

Tmux MCP 服务

模型上下文协议服务，可让 Claude Desktop 与 tmux 会话内容交互并查看内容。此集成允许 AI 助手读取、控制和观察你的终端会话。

功能

• 列出和搜索 tmux 会话
• 查看和切换 tmux 窗口及窗格
• 捕获并公开任意窗格中的终端内容
• 在 tmux 窗格中执行命令并获取结果（风险自负 ⚠️）
• 创建新的 tmux 会话和窗口
• 按自定义大小水平或垂直拆分窗格
• 结束 tmux 会话、窗口和窗格

快来看看这段短视频，感受一下！

前置条件

• Node.js
• 已安装并运行 tmux

使用方法

配置 Claude Desktop

将此 MCP 服务添加到 Claude Desktop 配置中：

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp"]
  }
}

MCP 服务选项

你可以选择指定正在使用的命令行 shell；如果未指定，默认使用 bash

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp", "--shell-type=fish"]
  }
}

MCP 服务仅在执行命令时需要知道 shell，以便正确读取其退出状态。

可用资源

• tmux://sessions - 列出所有 tmux 会话
• tmux://pane/{paneId} - 查看指定 tmux 窗格的内容
• tmux://command/{commandId}/result - 获取已执行命令的结果

可用工具

• list-sessions - 列出所有活动的 tmux 会话
• find-session - 按名称查找 tmux 会话
• list-windows - 列出 tmux 会话中的窗口
• list-panes - 列出 tmux 窗口中的窗格
• capture-pane - 捕获 tmux 窗格中的内容
• create-session - 创建新的 tmux 会话
• create-window - 在 tmux 会话中创建新窗口
• split-pane - 按可选大小水平或垂直拆分 tmux 窗格
• kill-session - 按 ID 结束 tmux 会话
• kill-window - 按 ID 结束 tmux 窗口
• kill-pane - 按 ID 结束 tmux 窗格
• execute-command - 在 tmux 窗格中执行命令
• get-command-result - 获取已执行命令的结果