Community코딩 & 개발github.com

ssmcp

SSH 연결된 ssmcp 워크스페이스를 목록 조회 및 코드 모드를 통해 운영합니다. 병렬 및 백그라운드 명령어, 제한된 대기, 클라이언트 재로드, 자동 검색된 코딩 하니스, 범위 제한 파일 접근 및 감사, 기존 Chrome 및 네이티브 브라우저 검색, 간결한 도구 검색, 스킬 및 명령어 검색, Linux rsync 전송 및 루프백 TCP 포워딩에 사용합니다.

ssmcp란 무엇인가요?

ssmcp는 여러 SSH 연결된 원격 워크스페이스를 통합 브리지로 관리하는 MCP 서버 기반 AI 에이전트 스킬입니다. `list` 명령으로 머신과 그 기능을 검색하고, 각 클라이언트의 `id`와 `title`을 기반으로 선택하여 `exec`로 독립 명령어 실행, `terminal`로 대화형 셸, `cua`로 컴퓨터 사용 자동화 등 다양한 도구를 제공합니다. Claude Code, Cursor, Codex, Pi, OpenCode 등 여러 플랫폼을 지원하며, `code_mode`에서 `tools.search`로 도구를 효율적으로 검색하고 `skills.view`로 스킬 문서를 확인할 수 있습니다. 특히 `exec.parallel`로 최대 32개 명령어를 동시 실행하고, `exec.start/list/status/wait/read/cancel/forget`로 장기 작업을 관리하며, rsync 전송을 위한 `jobs.*`도 지원합니다. 파이프라인, 셸 확장, 환경 변수 설정, 파일 시스템 접근 권한 제어, 루프백 TCP 포워딩까지 포괄하는 강력한 원격 작업 플랫폼입니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/LIghtJUNction/ssmcp/tree/HEAD/skills/ssmcp

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ssmcp 통합 워크스페이스 브리지

머신과 그 기능 검색

먼저 list를 호출하세요. 각 클라이언트의 선택적 title을 사용하여 작업을 이해한 다음, name과 cwd를 확인하세요. 반환된 id로 클라이언트를 선택하세요. 제목, 이름, 호스트네임은 레이블이며 중복될 수 있습니다. code_mode 내에서 tools.search(clientId,{query,limit:20})를 사용하여 간결한 도구 요약을 찾고, 호출하기 전에 완전한 네이티브 디스크립터를 위해 include_schemas:true를 요청하세요. 이전 브로커에서는 list({client_id}) 또는 tools(clientId,cursor) 페이지네이션을 사용하세요. 각 네이티브 백엔드의 권한 및 승인 정책을 존중하세요.

각 도구 카탈로그 탐색은 반환된 커서를 유지하세요. 네이티브 도구 디렉토리가 변경되더라도 페이지는 동일한 스냅샷을 공유합니다. 업데이트를 검색하려면 새로운 커서 없는 요청을 시작하세요. 클라이언트는 최대 4개의 스냅샷과 총 64MiB의 직렬화된 JSON을 유지합니다. 각 성공적인 페이지 읽기는 120초 유휴 시간 초과를 갱신하지만, 스냅샷은 생성 후 최대 900초 후에 만료됩니다. 유효하지 않은 커서는 이를 갱신하지 않으며, 변경되지 않은 카탈로그를 재사용해도 생성 시간이 재설정되지 않습니다. LRU 및 용량 제한으로 인해 더 빨리 제거될 수 있습니다. 서버가 스냅샷 만료 또는 제거를 보고하면 검색을 다시 시작하세요.

현재 클라이언트는 type:"shell"로 연결되며, 하니스 없이도 메인 대화형 터미널, 추가 독립 터미널, 독립 명령 작업, 파일 및 컨텍스트 도구를 제공합니다. 백그라운드 검색은 설치된 프로바이더를 확인하고, 버전, 시작 정책, 핸드셰이크 및 실제 카탈로그가 사용 가능한 인터페이스만 등록합니다. ssmcp.harnesses.list는 상태 및 진단을 보고하며, 사용 불가능한 프로바이더가 Shell 또는 다른 도구를 제거하지 않습니다. 시작 명령에서 사용되지 않는 -t, --type, --backend 및 후행 백엔드 인수를 제거하세요.

검색은 런타임, 종속성 또는 하니스를 설치하거나, 모델 요청을 제출하거나, 네이티브 권한을 완화해서는 안 됩니다. 오프라인 패키지 캐시를 아무것도 설치되지 않을 것이라는 증거로 취급하지 마세요. 확인된 안전한 시작이 없는 프로바이더는 사용할 수 없는 상태로 유지됩니다. Pi 검색은 SSMCP_PI_RPC_SOCKET을 통해 명시적으로 구성되고 이미 초기화된 네이티브 JSONL RPC 세션에만 연결됩니다. 절대 Unix 소켓과 그 직계 상위 디렉토리는 현재 UID에 속해야 하며, 그룹/기타 권한이 없어야 하고 심볼릭 링크가 아니어야 합니다. 연결된 피어 UID, 설치된 바이너리 및 버전은 5초 get_state 핸드셰이크 전에 확인됩니다. OpenCode 검색은 http://127.0.0.1:PORT/ (SSMCP_OPENCODE_URL, OPENCODE_PASSWORD)의 기존 서비스에만 연결됩니다. 명시적 포트와 루트 경로가 필요하며, 프록시, 리디렉션, 다른 호스트, 사용자 정보, 쿼리 및 프래그먼트는 거부됩니다. 네이티브 검색은 정보와 OpenAPI만 읽습니다. 이벤트 구독은 지연됩니다. 누락된 엔드포인트는 사용 불가를 의미합니다. 두 어댑터 모두 외부 서비스를 시작하거나 사용자 확장을 비활성화하여 완전한 카탈로그를 생성하지 않습니다.

list와 tools는 하나의 레지스트리를 사용하며, 라우팅 네임스페이스와 함께 네이티브 스키마와 디스크립터를 보존합니다. 네임스페이스에는 codex.*, claude.*, pi.*, opencode.* 및 네이티브 MCP 검색이 성공할 때 playwright.*가 포함됩니다. 정확한 이름은 현재 카탈로그에서 가져옵니다. Codex MCP 도구는 네이티브 mcpServerStatus/list를 통해 열거되고 mcpServer/tool/call을 통해 전달됩니다. 서버를 하드코딩하지 않고 검색된 codex.mcp.* 이름을 선택하세요. Pi는 사용 가능할 때 pi.rpc, ssmcp.pi.events, ssmcp.pi.requests, ssmcp.pi.respond 브리지 작업만 노출합니다. CLI 설치 또는 알려진 제어 명령 목록은 모델, 플러그인 또는 내부 MCP 도구 스키마의 열거가 아닙니다.

ssmcp://guide, ssmcp://limits, ssmcp://clients를 MCP 리소스 또는 code_mode 내에서 resources.read(uri)를 통해 읽으세요. 클라이언트 특정 리소스에 대해 resources.templates()를 사용하세요. 연결된 클라이언트가 이전 버전일 때 현재 카탈로그를 확인하세요.

code_mode는 MCP 서버에서 실행됩니다. 해당 파일 시스템과 루프백 네트워크는 호출자의 워크스페이스가 아닙니다. 샌드박스나 다른 컴퓨터를 전송에 포함하려면 해당 환경에서 별도의 ssmcp 클라이언트를 실행하고 반환된 ID를 선택하세요. 공유할 디렉토리에서 시작하세요:

cd /path/to/workspace
ssmcp --name workspace --title "Describe this session's task" --allow YOUR_GITHUB_LOGIN@github [email protected]

운영자가 구성한 SSH 대상 및 권한 있는 ID를 사용하세요. 개인 SSH 키를 복사하거나, 호스트 키 확인을 비활성화하거나, 네트워크 정책을 우회하지 마세요. 호출자 환경이 연결할 수 없으면 정확한 제한 사항을 보고하고 연결 가능한 피어에서 작업을 계속하세요.

사용 가능한 스킬 및 명령어 파일 검사

context.roots(id)를 사용하여 워크스페이스 및 명시적 읽기 전용 컨텍스트 루트를 확인하세요. 간결한 Markdown 인덱스를 위해 skills.view(id)로 시작하거나 메타데이터를 위해 skills.list(id,options)로 시작하세요. 동일한 스캔 옵션을 사용하여 next_cursor를 따르세요. 이름은 중복될 수 있으며, 루트 및 경로로 선택한 다음 skills.read(id,{path})를 호출하여 전체 SKILL.md를 읽으세요.

agents.resolve(id,{path:"src/lib.rs"})는 루트에서 대상 순서로 명령어 출처와 정확한 내용을 반환합니다. agents.list는 출처만 반환하고, agents.read는 선택한 파일을 읽습니다. 각 디렉토리에서 ssmcp는 첫 번째 비어 있지 않은 AGENTS.override.md, AGENTS.md 또는 agents.md를 선택합니다. 관련 명령어를 적용하기 전에 출처와 진단을 검토하세요.

기본 루트는 클라이언트의 시작 워크스페이스입니다. 운영자는 반복된 --context-root PATH를 사용하여 최대 8개의 읽기 전용 루트를 추가할 수 있습니다. root 옵션으로 반환된 ID를 명시적으로 선택하세요. 스킬 폴더를 직접 포함하는 루트는 paths:["."]로 스캔할 수 있습니다. 이러한 컨텍스트 루트는 일반 파일 쓰기 접근을 확장하지 않습니다. 이것은 현재 디스크 보기이며, 백엔드 모델의 로드된 프롬프트 목록이 아닙니다. 메타데이터 구문 분석은 문서화된 YAML 하위 집합을 사용합니다. 진단을 읽고 본문 텍스트에서 누락된 설명을 추론하지 마세요.

명령어 실행 및 관리

exec를 사용하여 종료 상태와 별도의 stdout/stderr이 있는 독립 명령어를 실행하세요. argv 배열, 승인된 워크스페이스 내의 선택적 cwd, 선택적 env 오버라이드를 전달하세요. 각 시작은 독립 프로세스와 파이프를 생성하며, 대화형 PTY를 통해 입력을 대기시키지 않습니다. 파이프라인이나 셸 확장의 경우 플랫폼 셸을 명시적으로 호출하세요. 명령어는 대화형 터미널 내에서 이후의 cd 또는 환경 변경을 상속하지 않습니다.

const client = clients.find(c => c.id === "CLIENT_ID_FROM_LIST");
if (!client) throw new Error("Select an online client from list");
return await exec.run(client.id, {
  command: ["git", "status", "--short"],
  cwd: client.cwd,
  wait_ms: 5000,
  max_bytes: 16384
});

job_id, running, state, exit_code, stdout, stderr, 두 출력 커서 및 snapshot을 읽으세요. 성공적인 시작은 실행 확인만 의미합니다. 프로세스 메타데이터에 pid_role이 포함된 경우 PID를 보고할 때 이를 유지하세요. 감독자 PID는 명령 PID가 아닙니다. running:false일 때만 최종 종료를 평가하세요. 0이 아닌 종료 코드는 도우미가 성공적으로 확인되었더라도 명령 실패입니다. snapshot은 최신 원자 상태와 출력 메타데이터를 포함합니다. wait_timed_out은 대기 단계를 기록하며, 이후 읽기에서 이미 완료가 표시될 수 있습니다.

대기는 명령 수명 주기와 분리하여 유지하세요. wait_ms는 기본값 5000이며 0..60000을 허용합니다. 만료 시 명령이 계속 실행됩니다. 명령의 timeout_ms는 기본값 0이며, 실행 기한이 없음을 의미합니다. 900000까지의 양수 값은 만료 시 프로세스 트리를 종료합니다. 외부 code_mode.timeout_ms를 전체 시퀀스에 충분히 길게 설정하세요. JavaScript 기한은 이미 시작된 명령을 취소하지 않습니다.

장기 작업의 경우 exec.start(clientId,{command,cwd})로 시작하고 즉시 job_id를 반환하세요. 이후 요청에서 계속하세요:

도우미목적
exec.list(clientId)실행 중 및 유지된 완료된 작업 찾기
exec.status(clientId,jobId)현재 상태, 기간, 종료 코드 및 아티팩트 메타데이터 검사
exec.wait(clientId,jobId,{wait_ms:5000})제한된 간격 내 완료 대기
exec.read(clientId,jobId,{stdout_cursor,stderr_cursor,max_bytes,wait_ms})증분 출력 및 원자 snapshot 읽기
exec.cancel(clientId,jobId)소유 프로세스 트리 종료 및 반환된 상태 검사
exec.forget(clientId,jobId)완료된 작업의 유지된 레코드 해제
exec.events(clientId,{cursor,max_events,wait_ms})제한된 명령 이벤트 읽기

stdout_cursor와 stderr_cursor를 읽기 사이에 별도로 유지하세요. 각 스트림은 읽기당 최대 32768바이트를 반환합니다. *_base64는 정확한 바이트를 보존하고 *_eof는 끝을 식별합니다. *_truncated가 true이면 해당 snapshot.stdout.artifact 또는 snapshot.stderr.artifact에서 이전 바이트를 읽으세요. 시작 후 관찰이 실패하면 재시도하기 전에 오류의 job_id를 status/read로 검사하세요. 중복 작업을 시작하지 마세요.

exec.parallel(clientId,[{command:[...]},...],{concurrency:4})를 사용하여 1~8개의 작업자로 최대 32개의 명령을 실행하세요. 각 작업자는 명령이 실제로 종료될 때까지 기다렸다가 다음을 시작합니다. 초기 wait_ms:0은 실행 중인 슬롯을 절대 해제하지 않습니다. 결과는 입력 순서를 유지하며 fulfilled/value 또는 rejected/reason을 포함합니다. 관찰 실패는 사용 가능한 경우 job_id를 유지하고 해당 작업자를 중지합니다. 대기열에 있는 항목 중 시작되지 않은 것은 not_started:true로 표시됩니다. 각 종료 코드를 검사하고 불확실한 작업을 재시도하기 전에 복구하세요. 내부 제한된 대기는 code_mode의 128-호출 예산 및 외부 시간 초과에 포함됩니다. 영구 서버에는 exec.start를 사용하세요. 병렬 출력은 기본적으로 스트림당 2048바이트입니다.

클라이언트당 최대 32개의 실행 중인 작업과 128개의 유지된 레코드를 예상하세요. 레코드 제한에 도달하면 새 시작이 가장 오래된 완료된 작업을 제거합니다. 실행 중인 작업은 등록된 상태로 유지됩니다. 작업은 code_mode 완료 후에도 유지되지만 클라이언트 연결 끊김 또는 재로드 시 중지됩니다. forget은 출력 아티팩트를 즉시 삭제하지 않습니다. 명령에는 exec.*를 사용하세요. rsync 전송 작업은 jobs.*로 관리합니다. 공유 대화형 셸이 필요할 때 terminal.*을 사용하고, 하나의 터미널 읽기에서 명령 완료를 추론하지 마세요.

백그라운드 입력 작성 및 터미널 선택

exec.write(clientId,jobId,{data,close_stdin:true})을 사용하기 전에 stdin:"pipe"로 명령을 시작하세요. 이진 입력에는 data_base64를 사용하세요. 두 형식을 동시에 제공하지 마세요. 각 쓰기는 32KiB로 제한됩니다. written, remaining_bytes, timed_out 및 closed를 검사하세요. 쓰지 않은 접미사만 재시도하세요. 입력을 닫으면 모든 바이트가 수락된 후 EOF를 보냅니다. 입력 본문은 감사 로그에 복사되지 않습니다.

terminal.open(clientId,{name,cwd,select})를 사용하여 독립적인 대화형 셸을 연 다음 terminal_id로 terminal.write/read/status/resize를 사용하세요. 출력 커서를 별도로 유지하세요. terminal.list는 선택된 로컬 보기를 보고합니다. terminal.select는 보기와 인간 키보드 대상을 변경하는 반면 다른 세션은 계속 실행됩니다. F7은 세션을 순환하고, F6은 감사 로그를 선택합니다. terminal_id를 생략하면 항상 선택된 보기와 관계없이 메인을 대상으로 합니다. terminal.close는 추가 세션을 종료합니다. 메인은 연결과 함께 종료됩니다. 최대 16개의 터미널이 열릴 수 있습니다.

현재 호출자/모델이 알려진 경우 외부 code_mode 요청과 함께 controller:{name,model}을 전달하세요. 클라이언트는 이 선언을 확인된 프로바이더 ID가 아닌 호출자 보고로 표시합니다. 애플리케이션 이름에서 모델을 추측하지 마세요. MCP clientInfo는 애플리케이션을 식별할 수 있습니다. 알 수 없는 모델은 알 수 없는 상태로 유지됩니다. 이전 클라이언트에서 선언을 표시하는 데 의존하기 전에 list의 controller_metadata를 확인하세요.

컴퓨터 사용을 위해 cua.status 및 네이티브 cua 스크린샷/입력/윈도우 메서드를 사용하세요. cua.browser는 브라우저 메서드를 공유합니다. 스크린샷을 image(await cua.screenshot(clientId,args))로 내보내고 좌표 메타데이터를 별도로 반환하세요. 현재 도구 카탈로그에서 발견된 정확한 codex.mcp.* 이름을 통해 Codex 연결 CUA MCP를 호출하세요. 네이티브 오류, 이미지 콘텐츠 및 승인 상태를 보존하세요. 이러한 작업을 프록시하기 위해 다른 모델을 호출하지 마세요.

기타 네이티브 도구 실행

const client = clients.find(c => c.id === "CLIENT_ID_FROM_LIST");
if (!client) throw new Error("Select an online client from list");
return await tools.search(client.id, {query:"browser", limit:10, include_schemas:true});

검색은 대소문자를 구분하지 않는 이름/설명 부분 문자열을 일치시킵니다. 기본적으로 이름, 관찰된 라우팅 네임스페이스 및 240 유니코드 문자로 축약된 설명을 반환합니다. include_schemas는 완전한 네이티브 디스크립터를 보존합니다. nextCursor로 계속할 때 동일한 클라이언트/쿼리/제한/스키마 옵션을 유지하세요. 검색은 모델에 표시되는 카탈로그 출력과 수동 페이지네이션을 줄이며, 첫 번째 기본 페이지 스캔을 줄이지 않습니다. 각 페이지는 여전히 승인되며 호출 예산에 포함됩니다. 제한된 작업을 위해 max_pages를 사용하세요. 변경되거나 만료된 페이지는 검색을 다시 시작해야 합니다. 과도하게 큰 스키마는 잘리지 않고 명시적으로 실패합니다. 예산은 ssmcp://limits를 참조하세요. 도우미는 업데이트된 브로커가 필요합니다.

발견된 작업을 await call(clientId, toolName, arguments)로 호출하세요. isError를 확인하고 structuredContent가 있으면 읽으세요. 짧은 결과는 인라인으로 유지됩니다. 과도하게 큰 백엔드 결과는 전체 본문 대신 아티팩트 메타데이터를 반환합니다. 모든 호출을 await하세요. 작업에 필요한 출력만 반환하세요. 사용자가 해당 위임을 승인하지 않는 한 네이티브 백엔드를 통해 에이전트나 모델을 시작하지 마세요.

네이티브 명령 프리미티브는 ssmcp.exec.start/list/status/wait/read/write/cancel/events이며, 완료된 레코드용 ssmcp.exec.forget이 있습니다. 이전 서버에 exec 도우미가 없으면 call(clientId, toolName, arguments)로 이러한 발견된 도구를 호출하고 전체 MCP 결과를 검사하세요. 스키마는 여전히 권위적입니다. 독립적인 네이티브 호출에는 Promise.all을 사용하세요. 모든 호출은 별도로 승인됩니다. 동시 Cargo 명령은 여전히 공유 빌드 잠금을 놓고 경쟁할 수 있습니다.

운영자의 기존 Chrome 재사용

사용자가 기존 Chrome 세션을 명명하면 call(id,"ssmcp.browser.discover",{}) 및 ssmcp.harnesses.list로 시작하세요. 검색은 메타데이터를 읽습니다. 설치된 확장 파일은 쌍을 이루는 승인된 연결을 설정하지 않습니다. 격리된 프로파일을 시작하지 마세요.

…

[번역을 위해 잘림]

관련 스킬