Tmux MCP Server

by nickgnd
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for listing, navigating, and interacting with tmux sessions, windows and panes. Enables capturing terminal content, executing commands in panes, and creating new tmux sessions and windows.

Tmux MCP 服务器

模型上下文协议服务器,使 Claude Desktop 能够与 tmux 会话内容交互并查看其内容。此集成允许 AI 助手读取、控制和观察您的终端会话。

特征

  • 列出并搜索 tmux 会话
  • 查看和导航 tmux 窗口和窗格
  • 从任何窗格捕获并显示终端内容
  • 在 tmux 窗格中执行命令并检索结果(使用风险自负⚠️)
  • 创建新的 tmux 会话和窗口

观看这段简短的视频,感受兴奋之情!

先决条件

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

用法

配置 Claude 桌面

将此 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 - 获取执行命令的结果
-
security - not tested
A
license - permissive license
-
quality - not tested

使 Claude Desktop 能够与 tmux 会话内容进行交互并查看其内容,从而允许 AI 助手读取、控制和观察终端会话。

  1. Features
    1. Prerequisites
      1. Usage
        1. Configure Claude Desktop
        2. MCP server options
      2. Available Resources
        1. Available Tools
          ID: 3o3o9iph0m