tmux会话管理服务

一个基于MCP协议的tmux会话管理服务器,使AI助手能够与tmux交互,实现终端复用、会话管理和命令执行。

  • by audibleblink
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 audibleblink/tmux-mcp-server

使用说明

@audiblelink/tmux-mcp服务器

用于管理本地tmux会话的MCP(模型上下文协议)服务器。使AI助手能够与tmux交互,以实现终端多路复用、会话管理和命令执行。

安装

npm install -g @audibleblink/tmux-mcp-server

或者直接使用npx运行:

npx @audibleblink/tmux-mcp-server

需求

  • Node.js>=18
  • tmux已安装并在PATH中可用

用法

使用克劳德桌面

添加到您的Claude桌面配置(~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tmux": {
      "command": "npx",
      "args": ["-y", "@audibleblink/tmux-mcp-server"]
    }
  }
}

使用OpenCode

添加到您的OpenCode配置(~/.config/opencode/config.json):

{
  "mcp": {
    "servers": {
      "tmux": {
        "type": "local",
        "command": ["npx", "-y", "@audibleblink/tmux-mcp-server"]
      }
    }
  }
}

独立

tmux-mcp-server

可用工具

会话管理

  • tmux_list_sessions -列出所有活动的tmux会话
  • tmux_create_session -创建新的tmux会话
  • tmux_kill_session -终止tmux会话
  • tmux_rename_session -重命名现有会话

窗口管理

  • tmux_list_windows -列出会话中的窗口
  • tmux_create_window -创建新窗口
  • tmux_kill_window -关闭一个窗口
  • tmux_select_window -切换到窗口
  • tmux_rename_window -重命名窗口

窗格管理

  • tmux_list_panes -在窗口中列出窗格
  • tmux_split_window -将窗口拆分为窗格
  • tmux_kill_pane -杀死窗格
  • tmux_select_pane -切换到窗格
  • tmux_resize_pane -调整窗格大小

交互

  • tmux_send_keys -将按键/命令发送到窗格
  • tmux_capture_pane -捕获窗格内容/输出

许可证

WTFPL