/ 디렉터리 / 플레이그라운드 / HolaOS
● 커뮤니티 holaboss-ai ⚡ 바로 사용

HolaOS

제작: holaboss-ai · holaboss-ai/holaOS

An open-source 'agent computer' — gives Claude a desktop-like surface for browsing, file ops, and app automation via MCP.

HolaOS is a runtime that provides a virtual environment for agents: filesystem, browser, app shims. Claude calls it via MCP and gets a sandbox where it can complete real digital chores. Useful when single MCP tools aren't enough.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "holaos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "holaos",
        "mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "holaos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "holaos",
        "mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "holaos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "holaos",
        "mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "holaos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "holaos",
        "mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "holaos-mcp",
      "command": "npx",
      "args": [
        "-y",
        "holaos",
        "mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "holaos-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "holaos",
          "mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add holaos-mcp -- npx -y holaos mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: HolaOS

Give Claude a sandbox desktop for multi-step chores

👤 Developers ⏱ ~15 min intermediate

언제 쓸까: Tasks like 'gather data from 5 sites, drop into a spreadsheet, draft an email' that span apps.

흐름
  1. Boot
    Start holaos; Claude sees the desktop tools.✓ 복사됨
    → Surface up
  2. Task
    Ask Claude to complete the chore using the sandbox.✓ 복사됨
    → Steps logged
  3. Review
    Replay the session before trusting outputs.✓ 복사됨
    → Audit done

결과: Cross-app chore done in an auditable sandbox.

조합

다른 MCP와 조합해 10배 효율

holaos-mcp + playwright-mcp

Use Playwright directly for fine-grained browser work; HolaOS for whole-desktop tasks

Combine holaos-mcp with playwright-mcp: Use Playwright directly for fine-grained browser work; HolaOS for whole-desktop tasks✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
fs / browse / app_call (see docs) Three coarse-grained surfaces 1 call

비용 및 제한

운영 비용

API 쿼터
Local resources
호출당 토큰
Mid — desktop sessions are chatty
금액
Free OSS
팁
Cap session length — long agent runs explode in tokens

보안

권한, 시크릿, 파급범위

최소 스코프: vm-control
자격 증명 저장: Session artifacts on disk
데이터 외부 송신: Whatever the agent reaches
절대 부여 금지: Expose the sandbox to a real user account without isolation

문제 해결

자주 발생하는 오류와 해결

Session goes stale

Restart the holaos runtime; sessions are not crash-safe yet

대안

HolaOS 다른 것과 비교

대안언제 쓰나단점/장점
UI-TARS-desktopYou want ByteDance's multimodal stackHeavier setup

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기