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.

Servidor MCP de Tmux

Servidor de Protocolo de Contexto de Modelo que permite a Claude Desktop interactuar con el contenido de las sesiones de tmux y visualizarlo. Esta integración permite a los asistentes de IA leer, controlar y observar las sesiones de su terminal.

Características

  • Listar y buscar sesiones de tmux
  • Ver y navegar por las ventanas y paneles de tmux
  • Capturar y exponer el contenido del terminal desde cualquier panel
  • Ejecuta comandos en los paneles de tmux y recupera resultados (úsalo bajo tu propio riesgo ⚠️)
  • Crear nuevas sesiones y ventanas de tmux

¡Mira este breve vídeo para emocionarte!

Prerrequisitos

  • Node.js
  • tmux instalado y funcionando

Uso

Configurar Claude Desktop

Agregue este servidor MCP a su configuración de Claude Desktop:

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

Opciones del servidor MCP

Opcionalmente, puede especificar el shell de línea de comandos que está utilizando; si no se especifica, el valor predeterminado es bash

"mcpServers": { "tmux": { "command": "npx", "args": ["-y", "tmux-mcp", "--shell-type=fish"] } }

El servidor MCP necesita conocer el shell solo cuando ejecuta comandos, para leer correctamente su estado de salida.

Recursos disponibles

  • tmux://sessions - Lista todas las sesiones de tmux
  • tmux://pane/{paneId} - Ver el contenido de un panel tmux específico
  • tmux://command/{commandId}/result - Resultados de los comandos ejecutados

Herramientas disponibles

  • list-sessions : enumera todas las sesiones activas de tmux
  • find-session - Encuentra una sesión tmux por nombre
  • list-windows - Lista de ventanas en una sesión tmux
  • list-panes - Lista de paneles en una ventana de tmux
  • capture-pane - Captura contenido de un panel tmux
  • create-session - Crea una nueva sesión tmux
  • create-window - Crea una nueva ventana en una sesión tmux
  • execute-command - Ejecutar un comando en un panel de tmux
  • get-command-result - Obtener el resultado de un comando ejecutado
-
security - not tested
A
license - permissive license
-
quality - not tested

Permite que Claude Desktop interactúe y vea el contenido de la sesión de tmux, lo que permite que los asistentes de IA lean, controlen y observen las sesiones de terminal.

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