ChatGPT 호환 MCP control plane
local-shell-mcp¶
Chat을 떠나지 않고 AI assistant에 제어된 shell, 실제 workspace, Git, browser automation, file sharing, remote-worker access를 제공합니다.
실제 coding environment¶
하나의 MCP endpoint에서 tests 실행, repository 검사, file patch, Git 조작, audit trail 유지를 수행합니다.
Runtime 및 client 레이어¶
Docker, VS Code extension, binary, Python, stdio 같은 runtime을 고른 다음 ChatGPT 또는 다른 MCP client를 별도로 연결합니다.
Remote machine control¶
SSH port를 열지 않고 outbound worker connection으로 NAT, firewall 또는 HPC machine을 연결합니다.
제공 기능¶
local-shell-mcp는 제어된 local/container workspace를 ChatGPT와 다른 MCP client에 노출합니다. Shell, persistent shell, filesystem, search, patch, Git, Playwright, audit, optional Goal Plan이 있는 durable logical Session, tokenized file link, remote-worker tool을 OAuth 지원 ChatGPT-compatible MCP server로 제공합니다.
AI가 repository를 검사하고 tests를 실행하고 files를 편집하고 Git을 조작하고 browser evidence를 수집하고 downloadable artifacts를 만들거나 control server로 outbound 연결만 가능한 remote machine을 제어해야 할 때 사용합니다.
아키텍처¶
Runtime layer: Docker / VS Code extension / binary / Python / stdio
Exposure layer: localhost / HTTPS proxy / tunnel / stdio pipe
Client layer: ChatGPT / generic MCP client / editor helper
Controlled workspace: /workspace or configured workspace root
Optional remote workers: outbound machine connections
의도된 isolation boundary는 service를 실행하는 container 또는 VM입니다.
시나리오별 시작¶
| 시나리오 | 시작 페이지 | 이유 |
|---|---|---|
| 첫 public ChatGPT deployment | Quickstart | OAuth와 /mcp 설정을 포함한 Docker Compose 경로 |
| runtime layer 선택 | Runtime choices | Docker, VS Code, binary, Python, stdio를 별도 runtime option으로 설명 |
| ChatGPT를 client로 추가 | ChatGPT connector | Endpoint, OAuth, 첫 안전 prompt, tool discovery |
| LSM을 DeepSeek Harness에 추가 | DeepSeek Harness plugin | 이 repository를 DSH bundle로 설치하면서 전체 LSM tool 및 remote-worker surface 유지 |
| VS Code에서 실행 | VS Code extension runtime | Editor-launched runtime 및 host safety 참고 |
| toolset 운영 방법 학습 | Usage patterns | Prompt template과 tool 선택 안내 |
| 모든 tool 이해 | Tools reference | 각 tool의 purpose, inputs, returns, combinations, notes |
| HPC, NPU/GPU 또는 server node 연결 | Remote workers | Outbound worker join flow 및 remote tool usage |
| 생성 file 공유 | File links | TTL과 revoke를 지원하는 tokenized download URL |
| deployment hardening | Security | Isolation, OAuth, workspace scope, audit logs |
주요 tool family¶
| Family | 예 | 용도 |
|---|---|---|
| Shell and Python | run_shell, run_python, shell_start |
Build, tests, scripts, long-running processes |
| Files and search | file_tree, file_grep, file_read, file_patch |
Repository inspection 및 precise edits |
| Git | run_shell, run_shell, run_shell, run_shell |
Review 가능한 source-control workflow |
| Sessions 및 Goal | session_manage, plan_manage |
durable task handoff, progress report, optional Goal mode |
| Browser | browser_session, browser_snapshot, browser_act, browser_run_script |
Persistent interaction, UI check, screenshot, rendered docs, page text |
| File links | link_create, link_revoke |
Chat에서 generated artifacts 다운로드 |
| Remote workers | remote_manage, run_shell, remote_transfer |
NAT, firewall 또는 cluster login flow 뒤의 machine |
대표 workflow¶
ChatGPT로 coding¶
- 전용 workspace에서 Docker Compose, VS Code extension, binary, Python 같은 runtime을 시작합니다.
- ChatGPT에 network access가 필요하면 HTTP runtime을 공개합니다.
- Public
/mcpendpoint를 ChatGPT에 추가합니다. - 먼저 repository 검사와 read-only checks를 요청합니다.
- 승인되면 file patch, tests, diff review, commit, push를 수행하게 합니다.
- File link 또는 remote system이 관련된 task에서는 audit log를 확인합니다.
Remote HPC 또는 accelerator host¶
- 일회성 remote worker invite를 만듭니다.
- 생성 command를 remote host에 붙여넣습니다.
- 일반 tools에
machine을 사용하고 Git은run_shell, path transfer는remote_transfer를 사용합니다. - Task 후 worker를 revoke합니다.
Artifact generation¶
- AI가
/workspace아래에 file을 생성하도록 합니다. - TTL/download limit가 있는 tokenized file link를 만듭니다.
- Link를 chat에 공유합니다.
- 완료되면 revoke합니다.
언어¶
이 site는 native MkDocs i18n plugin으로 build됩니다. Header의 language selector로 English와 translated pages를 전환합니다. 번역이 없는 page는 English로 fallback됩니다.