基本能力
产品定位
Tmux MCP Server 是一个用于终端会话管理的工具，特别适用于开发者和系统管理员，通过 AI 助手增强对 tmux 会话的控制和观察能力。
核心功能
- 列出和搜索 tmux 会话
- 查看和导航 tmux 窗口和窗格
- 捕获和展示任何窗格的终端内容
- 在 tmux 窗格中执行命令并获取结果（使用需谨慎 ⚠️）
- 创建新的 tmux 会话和窗口
适用场景
- 开发者需要 AI 助手协助管理多个终端会话
- 系统管理员需要远程监控和控制终端会话
- 团队协作时共享终端会话内容
工具列表
list-sessions: 列出所有活动的 tmux 会话find-session: 按名称查找 tmux 会话list-windows: 列出 tmux 会话中的窗口list-panes: 列出 tmux 窗口中的窗格capture-pane: 捕获 tmux 窗格的内容create-session: 创建新的 tmux 会话create-window: 在 tmux 会话中创建新窗口execute-command: 在 tmux 窗格中执行命令get-command-result: 获取执行命令的结果
使用教程
使用依赖
- Node.js
- tmux 已安装并运行
安装教程
- 配置 Claude Desktop，将以下内容添加到配置文件中：
json
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "tmux-mcp"]
}
} - 可选：指定命令行 shell 类型（默认为
bash）
json
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "tmux-mcp", "--shell-type=fish"]
}
}
调试方式
- 使用
list-sessions工具检查是否成功列出 tmux 会话 - 使用
capture-pane工具验证是否能正确捕获窗格内容 - 使用
execute-command工具测试命令执行功能
常见问题解答
- 问题：MCP 服务器无法连接到 tmux 会话
解决方案：确保 tmux 已安装并运行，且 Node.js 环境配置正确 - 问题：命令执行结果无法获取
解决方案：检查指定的 shell 类型是否正确，确保命令有明确的退出状态
