MCP ExplorerExplorer

Tmux Mcp Tools

@PsychArchon 7 months ago
1 MIT
FreeCommunity
AI Systems
MCP server providing tmux integration tools

Overview

What is Tmux Mcp Tools

tmux-mcp-tools is a set of tools designed for integrating MCP server functionalities with tmux sessions, allowing users to interact with tmux more effectively.

Use cases

Use cases for tmux-mcp-tools include automating tasks in tmux sessions, managing multiple terminal panes efficiently, and integrating AI agents into terminal workflows.

How to use

To use tmux-mcp-tools, configure your .tmux.conf file by adding a keybinding that opens the client in a new pane. You can also set up the MCP server configuration in mcp.json and use the provided commands to interact with tmux panes.

Key features

Key features include capturing the content of a tmux pane, sending commands with automatic Enter, sending keys without automatic Enter, and writing content to a file using heredoc pattern in a tmux pane.

Where to use

tmux-mcp-tools can be used in development environments, particularly where tmux is utilized for terminal multiplexing, enhancing productivity and workflow management.

Content

tmux-mcp-tools

Provide MCP tools for interacting with tmux sessions.

Configuration

  • Custom XDG: $XDG_CONFIG_HOME/tmux-mcp-tools/
  • mcp.json: MCP server configuration following Cursor format
  • prompt.md: System prompt template for the AI agent

Tmux Configuration

Add the following to your .tmux.conf file to create a keybinding that opens the client in a new pane:

bind-key M-k split-window -h -p 33 "uvx --from tmux-mcp-tools tmux-agent --target \"$(tmux display-message -t ! -p '#{pane_id}')\" ;"

This will bind Alt+K to open a new pane with the client, targeting the current pane.

Features

Tmux Tools

  • tmux_capture_pane: Capture the content of a tmux pane
  • tmux_send_command: Send commands to a tmux pane with automatic Enter key
  • tmux_send_keys: Send keys to a tmux pane without automatic Enter
  • tmux_write_file: Write content to a file using heredoc pattern in a tmux pane

Usage

{
  "mcpServers": {
    "tmux-mcp-tools": {
      "command": "uvx",
      "args": ["tmux-mcp-tools"]
    }
  }
}

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers