Terminal Sessions MCP

终端会话MCP

通过模型上下文协议为AI助手提供交互式、持久的终端会话

Web GUI Demo

为何这很重要

虽然许多人工智能工具提供基本的命令执行，但终端会话MCP提供了独特的功能：

是什么让它与众不同：

• 会话在IDE重启后仍然存在 -与典型的工具不同，即使关闭Cursor/Claude Desktop，您的会话也会持续存在
• 具有日志访问权限的后台任务 -在后台运行开发服务器、构建或测试，同时保留对其输出的完全访问权限
• 真正的互动 -向提示发送输入、处理确认、响应交互式工具
• 过程控制 -发送信号（Ctrl+C、Ctrl+Z）以优雅地管理长时间运行的进程
• 环境优美 - cd, export，并且环境变化在命令之间持续存在
• 可视化调试 -截取终端输出截图以调试TUI应用程序
• 上下文搜索 -使用正则表达式搜索命令历史记录并输出

您的AI助手现在可以在后台运行服务器，同时处理其他任务，维护持久的开发环境，处理交互式工作流，甚至构建具有视觉反馈的终端UI应用程序。

MCP功能

✅ 真正持久的会话 -会话在Cursor/IDE重启后仍然存在，保持所有状态\ ✅ 交互式工作流 -处理密码提示、确认和交互式工具\ ✅ 构建和调试TUI -通过截图开发具有视觉反馈的终端UI应用程序\ ✅ 过程控制 -向正在运行的进程发送信号（SIGINT、SIGTERM、SIGTSTP）\ ✅ 庄严的壳牌 - cd, export，其他状态变化在AI响应中持续存在\ ✅ 日志搜索 -使用正则表达式和上下文搜索命令历史记录和输出\ ✅ 服务管理 -通过智能就绪检测启动服务\ ✅ 智能命令执行 -检测命令何时完成，处理长时间运行的进程\ ✅ 多会话管理 -按名称跟踪多个服务/会话\ ✅ 终端屏幕截图 -捕获可视化丰富的终端输出以进行调试\ ✅ 实时流媒体 -实时观察输出，而不仅仅是最终结果

AI助手快速入门

1.安装

选项A：全局安装（推荐）

npm install -g term-sessions-mcp

选项B：本地安装

npm install term-sessions-mcp

2.启动终端会话服务器

这是实际管理终端会话的后端服务器：

如果全局安装：

session-server
# Starts session server on port 3100 (with GUI on port 3200)

如果本地安装：

npx session-server

无头模式（无GUI）：

session-server --headless

远程访问（绑定到所有接口）：

session-server --host 0.0.0.0 --token your-secret-token

保持此服务器运行 在后台，你的AI助手将连接到它。

3.为您的AI配置MCP网桥

这将您的AI助手（Cursor/Claude）连接到会话服务器：

对于光标：

1. 打开光标设置
2. 首选 光标设置 → 主控程序
3. 点击 “添加自定义MCP”
4. 这将为您的MCP配置打开一个编辑器
5. 添加以下内容：

{
  "mcpServers": {
    "terminal-sessions": {
      "command": "terminal-sessions-mcp",
      "env": {
        "SESSION_SERVER_PORT": "3100"
      }
    }
  }
}

对于Claude Desktop： 添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "terminal-sessions": {
      "command": "terminal-sessions-mcp",
      "env": {
        "SESSION_SERVER_PORT": "3100"
      }
    }
  }
}

如果上述方法不起作用，您可能需要使用完整路径。通过以下方式查找：

which terminal-sessions-mcp

然后在配置中使用该路径：

{
  "mcpServers": {
    "terminal-sessions": {
      "command": "/full/path/to/terminal-sessions-mcp",
      "env": {
        "SESSION_SERVER_PORT": "3100"
      }
    }
  }
}

重要提示：

• 确保 session-server 正在运行 在启动Cursor/Claude之前，在端口3100上
• 这 terminal-sessions-mcp 可执行文件是MCP桥，Cursor/Claude会自动运行它
• 你不需要跑 terminal-sessions-mcp 手动-仅运行 session-server

4.与您的AI助手一起使用

您的AI助手现在可以访问这些MCP工具：

• startService -通过就绪检测启动服务
• runCommand -在会话中执行命令
• tailLogs -获取会话的最新输出
• searchLogs -使用正则表达式搜索输出
• sendInput -将输入发送到交互式提示
• sendSignal -向进程发送信号（Ctrl+C等）
• listSessions -查看所有活动会话
• killSession -优雅或有力地停止会话
• takeScreenshot -捕捉终端视觉状态

Web GUI（可选）

该服务器包括一个可选的基于web的GUI，供操作员监控会话并与会话交互：

特征：

• 📊 仪表板显示所有活动会话的实时状态
• 🖥️ 完整的xterm.js终端模拟器，支持256色
• 🖱️ TUI应用程序（Midnight Commander、htop等）中完全支持鼠标
• ⌨️ 通过正确的键码转发进行直接键盘输入
• 📐 自动调整大小以实现完美的坐标映射
• 🎨 美丽的GitHub启发的黑暗主题
• 🔄 实时输出流
• ⚡ 信号控制（Ctrl+C、Ctrl+Z、SIGTERM）

访问权限： 打开 http://localhost:3200 在启用GUI（默认）的情况下运行时，或使用 --headless 禁用。

TUI控制序列支持

所有终端控制序列都能完美工作，实现丰富的TUI应用：


• ✅ 光标定位 - `\033 作为Connectome项目的一部分。

提取为独立包，因为具有适当TUI支持的终端会话管理对于人工智能辅助开发工作流程普遍有用。

贡献

欢迎投稿！请在GitHub上打开问题或PR。

______________________________________________________________________

星⭐ 如果你觉得这个仓库有用的话！