os-control-mcp

지속적인 터미널 세션을 위한 로컬 MCP 서버. 이 프로세스는 Bash, CMD, PowerShell, pwsh 또는 WSL을 활성 상태로 유지하며, 입력 전송과 출력의 증분 읽기를 분리합니다.

또한 지속적인 목표(goal)를 지원합니다: 에이전트는 수락 기준이 있는 목표를 생성하고, 여러 단계를 실행하며, 증거를 확인하고, 완료, 실패, 차단 또는 정의된 한도에 도달할 때까지 계속할 수 있습니다.

주의: 이 서버는 실행하는 사용자의 권한으로 프로세스를 제어합니다. 로컬에서만 사용하고, 기본적으로 관리자/root로 실행하지 말며, 프로세스를 인터넷에 직접 노출하지 마십시오.

전송(Transport)

서버는 stdio를 통해 MCP JSONL을 사용합니다. 기본적으로 네트워크 포트를 열지 않습니다.

Related MCP server: Persistent Terminal MCP Server

셸(Shells)

• 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, 셸, 디렉터리 및 종료 상태를 추적합니다.

autonomous 목표 외부에서는 잠재적으로 파괴적인 명령에 명시적 확인이 필요합니다. 자율 목표에서는 목표에 정의된 단계 및 시간 한도 내에서 권한 부여가 지속됩니다. 서버는 로컬 사용을 위한 것이며, 원격 터널 뒤에 배치할 때는 인증과 범위 지정으로 계속 보호해야 합니다.

자율 목표(Autonomous Goals)

권장 흐름:

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가 사용자의 컴퓨터에 접근할 수 없습니다.