os-control-mcp

用于持久终端会话的本地 MCP。该进程保持 Bash、CMD、PowerShell、pwsh 或 WSL 处于活动状态，并将输入发送与输出的增量读取分开。

它还具备持久目标：代理可以创建带有验收标准的目标，执行多个步骤，验证证据，并持续进行直到完成、失败、受阻或达到设定的限制。

注意： 此服务器以运行它的用户的权限控制进程。请在本地使用，默认不要以管理员/root 身份运行，并且切勿将进程直接暴露到互联网。

传输

服务器通过 stdio 使用 MCP JSONL。默认不打开网络端口。

Related MCP server: Persistent Terminal MCP Server

Shell

• 在 POSIX 系统上：bash、sh、zsh；

• 在 Windows 上：cmd、powershell 和 pwsh；

• 在 Windows 上：wsl-bash，使用 OS_CONTROL_WSL_DISTRO 中定义的发行版，默认为 kali-linux。

交互流程

1. os_create_session 创建持久会话。

2. os_send_input 立即写入 PTY/ConPTY。

3. os_read_output 使用 since_seq 仅获取新输出。

4. os_session_status 跟踪 PID、shell、目录和终止状态。

在 autonomous 目标之外，可能具有破坏性的命令需要明确确认。在自主目标中，授权在目标定义的步骤和时间限制内持续有效。该服务器用于本地使用，当置于远程隧道之后时，应继续通过身份验证和范围界定进行保护。

自主目标

推荐流程：

1. os_create_session 创建持久终端。

2. os_goal_start 接收目标、标准和 session_id。

3. os_send_input 使用 goal_id 执行，无需重复确认。

4. os_read_output 读取增量输出。

5. os_goal_update 记录操作、结果、证据和下一步。

6. 代理重复执行，直到所有标准得到验证。

服务器不会自行发明下一步操作，也不会单独调用模型；它维护目标的状态和限制。客户端/代理应持续进行调用，直到达到终止状态。

安装

git clone https://github.com/Willian-2-0-0-1/os-control-mcp.git
cd os-control-mcp
python -m pip install -r requirements.txt

在 Windows 上，pywinpty 为 CMD 和 PowerShell 启用 ConPTY。在 Kali/Linux 上，后端使用原生 PTY。.mcp.json 文件可供接受通过 stdio 的本地服务器的 MCP 客户端使用。

用于 GPT/Codex 的插件

仓库包含 .codex-plugin/plugin.json 清单和 MCP 服务器。这允许将包分发给兼容 MCP 插件的客户端。

要在 ChatGPT 中使用本地服务器，每个用户必须运行自己的实例并配置私有连接。仅凭 GitHub 仓库本身，并不能让 ChatGPT 访问用户的计算机。