Tmux MCP 服务器

一个模型上下文协议（Model Context Protocol）服务器，允许Claude Desktop与您的tmux会话内容交互并查看。此集成使AI助手能够从、控制并观察您的终端会话。

功能

• 列出和搜索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会话中创建新窗口
• execute-command - 在tmux窗格中执行命令
• get-command-result - 获取已执行命令的结果