mcpField
T
tmux-mcp-tools

tmux-mcp-tools

本地服务
github.com/PsychArch开发工具74 周前更新
代码仓库

关于 tmux-mcp-tools

已退役且不再维护的 tmux MCP 服务，历史上用于创建和操作 tmux 会话中的窗格。项目现保留文档供参考，并建议直接通过 Agent 的 shell 工具使用 tmux。

主要功能

  1. 01创建专用 tmux 窗格
  2. 02读取窗格内容及滚动历史
  3. 03发送按键或执行命令
  4. 04通过 heredoc 写入文件

适用场景

  1. 01参考历史 MCP 工具接口
  2. 02按文档改用 shell 工具操作 tmux

MCP 相关

历史版本通过 MCP 提供 tmux 窗格创建、读取、按键输入、命令执行和文件写入工具；项目已退役，不再维护。

#tmux#mcp#tools#integration

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "tmux-mcp-tools": {
      "command": "uvx",
      "args": [
        "tmux-mcp-tools"
      ]
    }
  }
}
启动命令uvx tmux-mcp-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypitmux-mcp-tools

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

tmux-mcp-tools

已退役

此项目于 2026-10-02 退役，不再维护。请直接通过 Agent 的 shell 工具使用 tmux。源代码保留供参考，自动发布到 PyPI 的流程已移除。

对于长时间运行或交互式任务，请创建专用的 tmux 窗口，记下其窗格 ID，并使用 send-keys 和 capture-pane 与其交互：

tmux new-window -d -n agent-task -P -F '#{pane_id}'
# Replace %12 with the pane ID returned above.
tmux send-keys -t %12 -l 'python -m http.server 8000'
tmux send-keys -t %12 Enter
tmux capture-pane -p -t %12 -S -100
tmux send-keys -t %12 C-c

以下文档介绍的是历史 MCP 接口。

提供用于与 tmux 会话交互的工具的 MCP 服务。

工具

  • tmux_create_pane：运行后台服务、REPL、远程 shell 或其他长时间运行的任务前，必须创建专用窗格
  • tmux_capture_pane：读取窗格内容，可选延迟和回滚
  • tmux_send_keys：发送原始按键（不会自动按 Enter），用于交互式程序
  • tmux_send_command：执行命令并自动按 Enter，可选等待模式
  • tmux_write_file：通过 heredoc 写入文件（适用于远程/SSH 环境）

配置

{
  "mcpServers": {
    "tmux-mcp-tools": {
      "command": "uvx",
      "args": ["tmux-mcp-tools"]
    }
  }
}
选项
  • --transport：stdio（默认）或 http
  • --host：HTTP 主机（默认：127.0.0.1）
  • --port：HTTP 端口（默认：8080）
  • --enter-delay：发送 Enter 前的延迟时间，单位为秒（默认：0.4）

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。