Tmux MCP Server

Name: Tmux MCP Server
Author: nickgnd

@nickgnd

代码仓库

关于 Tmux MCP Server

A MCP server for our beloved terminal multiplexer tmux.

#tmux #mcp #mcp-server

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

nickgnd

提交者

Nicolò Gnudi

配置

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

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

工具

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

Create a new tmux session

Create a new window in a tmux session

Split a tmux pane horizontally or vertically with optional size

Kill a tmux session by ID

Kill a tmux window by ID

Kill a tmux pane by ID

Execute a command in a tmux pane

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

FAQ from Tmux MCP Server

What prerequisites does Tmux MCP Server require?

Node.js and a running tmux installation are required.

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.

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.