Tmux MCP Server

@fr1sk

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

fr1sk

提交者

fr1sk

关于 Tmux MCP Server

暂无概览

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

Tmux MCP Server 配置

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

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

Tmux MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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 服务器

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w