tmux-mcp

Name: tmux-mcp
Author: fr1sk

@fr1sk

代码仓库

关于 tmux-mcp

暂无概览

#tmux #terminal #mcp #developer-tools #shell #bash #logs #log #debugging #debug #claude #cursor #windsurf #opencode #codex #cline #ai-tools

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

fr1sk

提交者

fr1sk

配置

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

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp"
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is tmux-mcp?

tmux-mcp is an MCP server that gives AI assistants full visibility into your tmux sessions — browse sessions, windows, and panes, read terminal output, and send commands. It works with Claude Code, OpenCode, Cursor, Windsurf, and any MCP‑compatible host. Optionally, it can route all shell commands through a named tmux session for live auditing.

How to use tmux-mcp?

Install globally with npm install -g @fr1sk/tmux-mcp, then add a local MCP server entry in your client’s config (OpenCode, Claude Code, Cursor/Windsurf). Use tools like list_sessions, capture_pane, send_keys, etc. Environment variables TMUX_MCP_ALWAYS_USE and TMUX_MCP_DEFAULT_SESSION control whether all shell commands are forced through tmux.

Key features of tmux-mcp

List all active tmux sessions with window count and status
Capture visible pane output with up to 5 000 lines of scrollback
Send shell commands or raw key sequences to any pane
Create, rename, split, and delete sessions / windows / panes
Error‑safe: returns readable messages instead of crashing on bad targets
Configurable wait time before capturing pane output after sending keys

Use cases of tmux-mcp

Browse tmux state and discover active sessions, windows, and panes
Read logs, compiler errors, server output, or test runs from a pane
Send commands (e.g., git status, npm test) and immediately read the result
Create new tmux sessions for projects and run commands in them
Route all AI‑driven shell commands through tmux for full auditability

FAQ from tmux-mcp

What MCP hosts are compatible with tmux-mcp?

Works with Claude Code, OpenCode, Cursor, Windsurf, and any MCP‑compatible host.

How do I target a specific pane for commands or capture?

Use tmux’s standard session:window.pane notation (e.g., work:0.0). Use list_sessions, list_windows, and list_panes to discover correct targets.

Can I force all AI shell commands to go through tmux?

Yes. Set the environment variable TMUX_MCP_ALWAYS_USE to "true" and optionally TMUX_MCP_DEFAULT_SESSION to a session name.

其他分类下的更多 MCP 服务器

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K