uvwt/agentdock

Secure MCP runtime for AI agents to operate local machines, servers, and containers with multi-device orchestration.

AgentDock MCP – 개요

AgentDock은 대규모 언어 모델(LLM) 챗봇 에이전트(ChatGPT, Claude, Grok 등)가 실제 컴퓨터, 서버, 컨테이너 또는 브라우저에서 안전하게 동작할 수 있도록 하는 런타임입니다. 채팅 UI를 제공하거나 모델을 직접 실행하지는 않습니다. 대신, AI 클라이언트가 파일 작업, 셸 명령 실행, Git 사용, 브라우저 자동화, 그리고 "Skills"(플러그인 도구) 호출을 수행할 수 있도록 MCP (Multi-Client Protocol) HTTP 엔드포인트를 노출합니다. 여러 AgentDock 인스턴스를 연결하여 단일 대화에서 여러 기기에 걸친 작업을 조정할 수 있습니다.

핵심 기능 (README 설명 기준)

영역	AgentDock 제공 기능
파일 및 명령 접근	UTF-8 파일 읽기/검색, 안전한 원자적 쓰기, 디렉토리 탐색 제한, 타임아웃이 있는 명령 실행, stdout/stderr 분리, PTY 지원, 장기 실행 세션, 출력 잘림 및 마스킹.
Skills 및 동적 MCP	내장 및 커뮤니티 제공 Skills (`uvwt/agentdock-skills`를 통해), 다이제스트 기반 원자적 교체를 통한 설치/업데이트/제거, 격리된 환경 변수, 동적 MCP 서버 등록, 스키마 검사.
네이티브 ACP	OpenAI Codex, Anthropic Claude, Grok 등을 위한 선택적 어댑터; ACP 세션 생성, 프롬프트 실행, 권한 요청 처리, 호스트 보안 경계 준수.
브라우저 및 데스크톱 자동화	브라우저 실행/종료, 탐색, 클릭, 입력, 대기, 페이지 텍스트/요소/네트워크 검사, 로그인 상태 유지, 스크린샷 캡처; macOS 데스크톱 자동화 포함.
복구 가능한 작업	작업 상태 지속성, 명시적 목표/단계, 체크포인트, 차단 요소 추적, 중단 후 재개, 최종 증거 기반 검토, 재사용 가능한 워크플로우 템플릿.
기기 간 조정	MCP를 통한 여러 AgentDock 노드(로컬, LAN 호스트, 클라우드 VPS) 연결; 장기 기억, 런북, 공유 메모, 아티팩트 프록시를 위한 선택적 NexusDock 통합.

일반적인 사용 흐름

각 기기(Docker, Linux, macOS, Windows 또는 컨테이너)에 AgentDock을 설치합니다. 기본 MCP 엔드포인트는 http://127.0.0.1:8765/mcp입니다.
인증을 구성합니다. 공개 배포 시에는 Bearer 토큰이나 OAuth가 필요합니다.
LLM 클라이언트의 도구 설정(예: ChatGPT의 "Tools" 설정)에 MCP URL과 토큰을 추가합니다.
채팅 중 LLM은 다음과 같은 도구 호출을 수행합니다:
- read_file, write_file, run_command: 대상 호스트에서 코드 편집 또는 테스트 실행.
- git_pull, git_push: 리포지토리 관리.
- browser.navigate 또는 desktop.click: 웹 페이지나 macOS 앱과 상호작용.
AgentDock은 호스트의 보안 샌드박스 내에서 요청을 실행하고, 결과, 로그 및 필요한 후속 프롬프트가 포함된 구조화된 JSON을 반환합니다.
여러 노드를 동일한 대화에서 지정할 수 있어, 단일 AI가 개발자의 노트북, CI 서버, 운영 VPS에 걸친 워크플로우를 조정할 수 있습니다.

설치 및 시작하기 (요약)

Docker – agentdockio/agentdock을 풀(pull)하고 실행합니다. 포트 및 토큰 설정은 문서를 참조하세요.
Linux – 자동화 스크립트 또는 수동 systemd 서비스.
macOS / Windows – 그래픽 설치 프로그램.
설치 후 제어판이나 터미널에서 MCP URL과 인증 토큰을 가져와 AI 클라이언트에 입력합니다.

주요 사용자

개발자: 모델에 무제한 셸 접근 권한을 주지 않고도 LLM이 코드를 편집하거나 테스트를 실행하고 직접 배포하게 하려는 경우.
Ops / SRE 팀: 엄격한 권한 경계 내에서 AI 에이전트가 서버, 컨테이너 또는 리버스 프록시를 관리하게 하려는 경우.
제품 팀: 실제 작업(파일 편집, 브라우저 자동화)을 안전하게 수행해야 하는 AI 기반 어시스턴트를 구축하는 경우.

프로젝트 상태 및 커뮤니티

활발히 유지 관리 중(CI 배지, 정기 릴리스, Docker 풀).
Apache 2.0 라이선스로 오픈소스 제공.
문서는 uvwt.github.io/agentdock-docs에서 호스팅.
QQ 그룹을 통한 커뮤니티 채팅; GitHub Issues/PRs를 통한 기여 환영.

요약

AgentDock은 LLM 챗봇 에이전트와 실제 기기를 연결하는 보안 런타임입니다. 파일 조작, 명령 실행, Git, 브라우저/데스크톱 자동화 및 확장 가능한 "Skills"를 위한 잘 정의된 HTTP 기반 프로토콜을 노출하여, 엄격한 접근 제어를 유지하면서 단일 AI 대화로 복잡한 다중 기기 워크플로우를 조정할 수 있게 합니다.