Tmux のエージェント指向の MCP サーバー — ネイティブ プロセスの検出、スマート トリガー、および 1 ハンドル: スロット。

クイックスタート

前提条件: tmux をインストール、1.26.1 + または事前ビルドされたバイナリー。

Claude コードの MCP クライアント config (~/.claude/settings.json) に追加します。

ターミナルを取得し、それを実行する - セットアップコールなし、持ち運びするハンドルなし:

なぜこれが存在しているのか

AIのコーディングの代理店(クロード コード、Codex CLI、Gemini CLI、opencode)はターミナル制御を必要とします。 MCP サーバは tmux を dumb パイプとして扱います: コマンドを送信, 出力のための poll, 繰り返し.

そのモデルは4つの方法で分解します。

• エージェントが npm run dev を起動し、サーバーが [Ready**] のときを知る必要があります。 それは出力を作り出します。
• エージェントはデータベースのマイグレーションを実行し、psqlが待っているときに検出する必要があります パスワード — 画面のテキストから推測しません。
• エージェントは5つの操作をチェーンし、各ステップ間の往復を調べる余裕はありません。
• 他の仕事をしている間、エージェントはバックグラウンドペインでビルドを監視します。

その4つの課題を直接解決します。

比較

| | NICkgnd/tmux-mcp | HT-mcp | mcp-interactiveterminal | tmux-mcp (this)** | お問い合わせ | 言語 | TypeScript | Rust | ノード.

tmux-mcp

Agent-oriented MCP server for tmux — native process detection, smart triggers, and one handle: the slot.

Quick start

Prerequisites: tmux installed, Go 1.26.1+ or a pre-built binary.

# Install via Go
go install github.com/MadAppGang/tmux-mcp/v2@latest

# Or build from source
git clone https://github.com/MadAppGang/tmux-mcp
cd tmux-mcp && go build -o tmux-mcp .

Add to your MCP client config (~/.claude/settings.json for Claude Code):

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp",
      "args": ["--shell-type", "zsh"]
    }
  }
}

Get a terminal and run something in it — no setup call, no handle to carry:

// A pane beside the agent is created on first use. Synchronous: blocks until
// the command finishes, and returns output plus the exit code.
{"tool": "execute-command", "params": {"command": "go build ./..."}}
// → {"slot": 1, "created": true, "output": "", "exitCode": 0, "timedOut": false}

// The same slot is the same pane next time.
{"tool": "capture-pane", "params": {}}
// → the pane's text, with structuredContent {"slot": 1}

Why this exists

AI coding agents (Claude Code, Codex CLI, Gemini CLI, opencode) need terminal control. Existing MCP servers treat tmux as a dumb pipe: send a command, poll for output, repeat.

That model breaks down in four ways:

• An agent starts npm run dev and needs to know when the server is ready — not when it produced any output.
• An agent runs a database migration and needs to detect when psql is waiting for a password — not guess from screen text.
• An agent chains five operations and cannot afford a lookup round-trip between each step.
• An agent watches a build in a background pane while doing other work.

This project solves those four problems directly.

Comparison

ht-mcp is fast and dependency-free but works only with headless terminals it creates itself. It cannot attach to existing sessions or manage pane layouts.