MCP.so
登录

Tmux MCP Server

@nickgnd

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

nickgnd

提交者

Nicolò Gnudi

关于 Tmux MCP Server

A MCP server for our beloved terminal multiplexer tmux.

Tmux MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "tmux": {
      "command": "npx",
      "args": [
        "-y",
        "tmux-mcp"
      ]
    }
  }
}

Tmux MCP Server 工具

13

List all active tmux sessions

Find a tmux session by name

List windows in a tmux session

List panes in a tmux window

Capture content from a tmux pane with configurable lines count and optional color preservation

Create a new tmux session

Create a new window in a tmux session

Kill a tmux session by ID

Kill a tmux window by ID

Kill a tmux pane by ID

Split a tmux pane horizontally or vertically

Execute a command in a tmux pane and get results. For interactive applications (REPLs, editors), use `rawMode=true`. IMPORTANT: When `rawMode=false` (default), avoid heredoc syntax (cat << EOF) and other multi-line constructs as they conflict with command wrapping. For file writing, prefer: printf 'content\n' > file, echo statements, or write to temp files instead

Get the result of an executed command

概览

What is Tmux MCP Server?

Tmux MCP Server enables Claude Desktop to interact with and view tmux session content, allowing AI assistants to read from, control, and observe terminal sessions.

How to use Tmux MCP Server?

Add this MCP server to your Claude Desktop configuration by specifying the command and arguments. Optionally set the shell type with --shell-type (defaults to bash). The server provides resources (tmux://...) and tools to list, capture, create, and kill tmux sessions, windows, and panes.

Key features of Tmux MCP Server

  • List and search tmux sessions
  • View and navigate tmux windows and panes
  • Capture and expose terminal content from any pane
  • Execute commands in tmux panes and retrieve results (use at own risk)
  • Create new tmux sessions, windows, and split panes
  • Kill tmux sessions, windows, and panes

Use cases of Tmux MCP Server

  • Let an AI assistant read the output of a running terminal process
  • Execute commands in a specific pane and inspect their results
  • Create new tmux windows or split panes during a session

常见问题

1

What prerequisites does Tmux MCP Server require?

Node.js and a running tmux installation are required.

2

How do I configure the shell type for command execution?

Use the `--shell-type` flag when starting the server, e.g., `--shell-type=fish`. Defaults to `bash`.

3

What resources and tools does Tmux MCP Server provide?

It provides resources like `tmux://sessions` and `tmux://pane/{paneId}`, and tools such as `list-sessions`, `capture-pane`, `execute-command`, `create-session`, `split-pane`, and more.

4

Is there any risk when using Tmux MCP Server?

Executing commands in tmux panes is done at your own risk, as indicated by the warning in the README.

5

Does Tmux MCP Server support authentication or transports?

The README does not mention any authentication or additional transport options beyond standard MCP.

评论

其他 分类下的更多 MCP 服务器