tmux-claude-mcp-server

michael-abdo/tmux-claude-mcp-server

3.3

If you are the rightful owner of tmux-claude-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The tmux-claude MCP Server is a highly efficient Model Context Protocol server designed for orchestrating Claude instances using a bridge pattern architecture, significantly reducing memory usage.

The tmux-claude MCP Server is an innovative solution for managing multiple Claude instances through a hierarchical orchestration model. By leveraging the Model Context Protocol (MCP), this server enables efficient communication and coordination between different roles such as Executives, Managers, and Specialists. The server employs a bridge pattern architecture, which allows for a single shared MCP server process, drastically reducing memory usage by up to 85% compared to traditional multi-server approaches. This architecture also ensures zero race conditions through centralized state management. The server supports both isolated and shared workspace modes, with integrated Git tools for seamless version control and conflict resolution. Additionally, a real-time web-based monitoring dashboard provides insights into active instances and system metrics, enhancing the overall management experience.

Features

  • Bridge Pattern Architecture: Reduces memory usage by 85% with a single shared MCP server process.
  • Hierarchical Orchestration: Supports roles like Executive, Manager, and Specialist for structured task management.
  • Workspace Modes: Offers isolated and shared modes with Git integration for version control.
  • Real-time Monitoring: Web-based dashboard for tracking active instances and system performance.
  • AI Conflict Resolution: Uses Claude for intelligent merge conflict resolution.

Usages

usage with Claude

bash
claude mcp add tmux-claude -s user node /path/to/tmux-claude-mcp-server/src/simple_mcp_server.js

usage with Node

bash
cd tmux-claude-mcp-server
npm install

Tools

  1. spawn

    Create new Claude instances with specific roles.

  2. send

    Send text or prompts to instances.

  3. read

    Read output from instances.

  4. list

    List active instances with filtering options.

  5. terminate

    Stop instances and optionally their children.