Shared PTY for human and agent面向人类与 Agent 的共享 PTY

SSH MCP server with a real shared terminal.把 SSH 变成真正可共享的 MCP 终端。

`ssh-session-mcp` is a shared SSH MCP server for Codex, Claude Code, Cursor, OpenCode, Cline, and other AI agents. It keeps one persistent PTY alive, adds a browser terminal viewer, tracks who typed what, and makes remote install, debugging, and long-running work safer to operate.`ssh-session-mcp` 是面向 Codex、Claude Code、Cursor、OpenCode、Cline 等 AI Agent 的共享 SSH MCP Server。它保留一条持久 PTY，会附带浏览器终端 viewer、输入来源跟踪和会话级状态管理，让远程安装、调试和长任务执行更可控。

Open Install Guide查看安装指南 Install from npm从 npm 安装 Browse Resources查看资源页

Best For最适合

MCP + SSH install and usage, AI-assisted remote terminals, embedded Linux boards, deployment hosts, and remote debugging.MCP + SSH 安装与使用、AI 辅助远程终端、嵌入式 Linux 板卡、部署机与远程调试。

Core Promise核心能力

Shared PTY, browser terminal, input lock, async command tracking, diagnostics, and safe/full execution modes.共享 PTY、浏览器终端、输入锁、异步命令跟踪、诊断信息，以及 safe/full 执行模式。

Fastest Demo最快演示

ssh-session-mcp-ctl launch --local --viewerPort=autossh-session-mcp-ctl launch --local --viewerPort=auto

ssh mcp mcp ssh server codex ssh mcp claude code ssh mcp shared pty browser ssh terminal

Why It Matters为什么值得看

Most SSH MCP tools run commands, but do not preserve the terminal as a shared runtime.很多 SSH MCP 工具能执行命令，但保不住“共享终端运行时”。

When installation prompts, long-running deploys, or remote debugging sessions depend on one real PTY, a stateless wrapper leaves both sides guessing. This project keeps both sides on the same terminal state.当安装提示、长时间部署、远程调试依赖一条真实 PTY 时，无状态包装层会让双方都只能靠猜。这个项目的目标就是让双方看到同一份终端状态。

shared PTYbrowser terminalremote debugging

What It Adds它补上了什么

A practical SSH MCP server for real operator + AI collaboration.一个真正面向“操作者 + AI 协作”的 SSH MCP Server。

State-aware command handling, safe/full modes, input lock, session history, async polling, viewer diagnostics, and a local demo path that explains the product without touching a real SSH target.它提供状态感知的命令处理、safe/full 模式、输入锁、会话历史、异步轮询、viewer 诊断，以及无需真实 SSH 目标的本地演示路径。

safe/full modeasync statussession history

Where To Go Next下一步看哪里

Each page helps with a different kind of question.不同页面分别解决不同的问题。

Start here for the overview, then jump to install, resources, FAQ, or use cases when you want the next layer of detail.先在这里看总览；如果你接下来想看安装、资源、问答或使用场景，再继续往下跳转。

install guideresourcesFAQ

Start Here从这里继续

Pick the page that matches what you need right now.按你现在要解决的问题继续往下看。

Some people want setup steps, some want links, and some want examples. These pages keep each path easier to browse.有人要安装步骤，有人要官方链接，也有人想看使用例子。把它们拆开以后，会更容易浏览。

Install安装

MCP + SSH install guideMCP + SSH 安装指南

Codex, Claude Code, Cline, OpenCode, npm, Docker, and Windows notes.覆盖 Codex、Claude Code、Cline、OpenCode、npm、Docker 和 Windows 注意事项。

Resources资源

Official links and article index官方链接与文章索引

One place for the package, source, registry info, mirrors, and articles.把包地址、源码、registry 信息、镜像和文章放到一个地方。

FAQ问答

Install and runtime questions安装与运行时问答

Direct answers to the questions people usually ask before or after setup.把安装前后最常见的问题集中回答清楚。

Use Cases场景

Why shared PTY matters为什么共享 PTY 值得要

Break down viewer, lock, async tracking, and policy rules by scenario instead of listing features flatly.按场景解释 viewer、输入锁、异步跟踪和策略规则的价值，而不是平铺功能名。

Next下一步

Not sure where to go next?还不确定下一步看哪里？

Go to install for setup, resources for links, FAQ for answers, and use cases for examples.安装页看接入，资源页看链接，FAQ 看答案，场景页看例子。

If you need install commands, start with the install guide.如果你需要安装命令，先去安装页。

That page keeps Codex, Claude Code, Cline, OpenCode, npm, Docker, and Windows setup in one place.那一页把 Codex、Claude Code、Cline、OpenCode、npm、Docker 和 Windows 的接入方式都放在一起。

Open Install Guide查看安装指南

If you want links, mirrors, or articles, open the resources page.如果你需要链接、镜像或文章，去资源页。

It gathers the package, source, registry metadata, mirrors, and writeups in one place.它把包地址、源码、registry 信息、镜像和文章都集中在一个地方。

Open Resources查看资源页