tmux-mcp

🚀 Tmux MCP 服务器

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 - 获取已执行命令的结果