antigravity-mcp-server

두 AI 에이전트가 서로의 파일을 건드리지 않고 동시에 앱을 빌드하게 하세요.

당신의 에이전트는 백엔드를 담당합니다. Antigravity는 UI를 담당합니다. 서로의 파일을 망가뜨리지 않습니다.

문제점

두 개의 AI 코딩 에이전트를 하나의 프로젝트에서 실행하는 것은 멋져 보이지만, 둘이 같은 파일을 편집하다가 서로의 작업을 조용히 망가뜨릴 때까지는 좋습니다.

서로를 볼 수 없습니다. 그것이 전체 문제입니다.

Related MCP server: asynkor

해결책

두 에이전트가 모두 연결하는 하나의 작은 서버입니다. 공유 메모리를 제공합니다: 누가 무엇을 하고 있는지, 어떤 파일이 점유되었는지, 서로에게 무엇을 전달해야 하는지.

   Your AI agent                                    Antigravity
   Claude Code · Cursor · Windsurf                  (agy CLI)
   VS Code · Gemini CLI · OpenCode
          │                                              │
          │  MCP                                     MCP │
          └──────────────┐                ┌──────────────┘
                         ▼                ▼
              ┌─────────────────────────────────┐
              │        antigravity-mcp-server          │
              │                                 │
              │   board.json                    │
              │    ├─ tasks .... who does what  │
              │    ├─ locks .... files taken    │
              │    ├─ notes .... messages       │
              │    └─ presence . who is online  │
              └─────────────────────────────────┘
                              │
                              └──► starts `agy` in the background

설치

npx antigravity-mcp-server init

이것뿐입니다. 이 명령 하나로:

• 컴퓨터에 있는 모든 AI 도구를 찾습니다

• 각 도구에 서버를 추가합니다

• Antigravity가 필요한 권한을 활성화합니다

이제 AI 도구를 다시 시작하여 변경 사항을 적용하세요.

매번 실행할 때마다 가져오는 대신 영구적으로 설치하려면:

npm install -g antigravity-mcp-server
antigravity-mcp-server init

기타 명령:

antigravity-mcp-server doctor           # is everything working?
antigravity-mcp-server doctor --probe   # same, plus a real round trip through agy
antigravity-mcp-server init --dry-run   # show changes, write nothing
antigravity-mcp-server init --all       # also write configs for tools you haven't installed
antigravity-mcp-server init --only claude-code,cursor

필요 사항: Node 18.17 이상, 그리고 Antigravity CLI (agy). agy가 없어도 공유 보드는 사용할 수 있습니다 — 단지 Antigravity에 작업을 넘길 수 없을 뿐입니다.

사용 방법

명령어를 배울 필요가 없습니다. 그냥 에이전트에게 말하면 됩니다:

"당신이 결제 API를 하는 동안 Antigravity로 체크아웃 페이지를 빌드해 주세요."

에이전트가 알아서 처리합니다. 실제로 일어나는 일은 다음과 같습니다:

  time ──────────────────────────────────────────────────────►

  your agent   ███ writes brief ███│████ payments API ████│ checks result
                                   │                      │
  Antigravity                      │███ checkout page ███ │
                                   │                      │
                                   └── both work at once ─┘

에이전트가 전체 브리프를 작성하고, 자신의 파일을 잠그고, 백그라운드에서 Antigravity를 시작한 후 계속 작업합니다. 아무도 기다리지 않습니다.

공유 보드가 중요한 이유

1. 파일 잠금

에이전트가 파일을 편집하기 전에, 파일을 점유합니다. 폴더를 잠그면 그 안의 모든 것이 잠깁니다.

  my-app/
  ├── api/           [locked] your agent    ← Antigravity is told "taken"
  ├── db.ts          [locked] your agent
  ├── components/    [locked] Antigravity   ← your agent stays away
  └── styles/        [locked] Antigravity

에이전트가 잠긴 파일을 가져오려고 하면 명확한 충돌 메시지를 받습니다. 조용한 덮어쓰기는 없습니다.

2. 메모

UI는 아직 존재하지 않는 API에 대해 빌드되고 있습니다. 따라서 두 에이전트는 계획을 주고받습니다:

"POST /api/orders가 준비되었습니다. { id, status }를 반환합니다. 폼을 연결하세요."

이것이 두 절반이 서로 맞물리도록 유지하는 요소입니다.

3. 존재감

각 에이전트는 시작하기 전에 다른 에이전트가 무엇을 하는지 확인할 수 있으므로 충돌하지 않는 작업을 선택합니다.

도구들

에이전트가 스스로 선택합니다. 사용자가 직접 입력할 필요가 없습니다.

알아두면 좋은 두 가지:

coop_status — 한 번 호출로 모든 것을 알 수 있습니다: 누가 온라인인지, 무엇이 실행 중인지, 무엇이 잠겼는지, 무엇이 읽지 않았는지.

ag_followup — 동일한 Antigravity 대화를 이어갑니다. 따라서 *"이제 모바일에서도 작동하게 해 주세요"*는 처음부터 시작하는 대신 모든 컨텍스트를 유지합니다.

내부 동작 방식

디스크의 파일

~/.antigravity-mcp/
├── board.json                    shared state, written under a lock
└── runs/
    ├── <task_id>.json            agy's raw result
    ├── <task_id>.prompt.txt      the brief that was sent
    └── <task_id>.err             stderr, if the run failed

board.json은 tasks, locks, notes, events, presence를 보유합니다. 모든 쓰기는 배타적 잠금(원자적으로 생성된 디렉토리 — Windows와 POSIX에서 동일하게 동작하는 기본 요소)을 취한 후, 쓰기-임시-후-이름-바꾸기 방식으로 저장되므로 충돌 시 반쯤 쓰여진 보드가 남지 않습니다. 20초보다 오래된 스테일(stale) 잠금은 자동으로 해제됩니다.

SQLite는 없습니다. 네이티브 빌드는 컴파일러가 없는 머신에서 npx를 망가뜨리고, node:sqlite는 아직 실험적이며 Node 22+가 필요합니다. 보드는 분당 소수의 작은 쓰기만 처리하므로 JSON 파일이 적절한 크기의 도구입니다.

위임

ag_delegate는 다음을 셸로 실행합니다:

agy --print <brief> --output-format json --print-timeout <n>s \
    --add-dir <cwd> --mode accept-edits --dangerously-skip-permissions

자식 프로세스는 **분리(detached)**되어 생성되며, stdout은 runs/<task_id>.json으로 직접 리디렉션됩니다. 즉, 긴 작업이 MCP 서버 재시작에도 살아남습니다 — 상태는 자식 핸들을 유지하는 것이 아니라 실행 파일을 읽고 PID를 확인하여 복구됩니다.

ag_followup은 agy의 JSON 출력에서 --conversation을 통해 conversation_id를 재사용하므로 컨텍스트가 호출 간에 이어집니다.

경로 잠금

경로는 path.resolve로 정규화되고 Windows에서는 대소문자가 구분되지 않으므로 C:\Proj와 c:\proj가 동일한 잠금을 우회할 수 없습니다. 중복은 양방향으로 확인됩니다 — api/routes.ts를 점유하면 보유 중인 api/와 충돌하고, api/를 점유하면 보유 중인 api/routes.ts와 충돌합니다.

에이전트 식별

각 측은 동일한 바이너리를 다른 --agent <id>로 실행합니다. 이 ID는 모든 보드 항목에 귀속됩니다. 하나의 ID를 공유하는 두 클라이언트는 서로의 잠금을 볼 수 없게 되어 전체 목적이 무산됩니다.

설정 파일이 기록되는 위치

init은 발견된 도구만 수정하며, 편집하는 모든 파일을 <file>.bak-antigravity-mcp로 백업합니다.

알아두면 좋은 점

긴 작업은 안전합니다. Antigravity는 분리되어 실행됩니다. 편집기나 서버가 다시 시작되어도 작업은 계속됩니다.

Antigravity는 묻지 않고 편집합니다. ag_delegate는 --dangerously-skip-permissions를 전달하므로 무인 작업이 가능합니다. auto_approve: false를 전달하면 프롬프트에서 멈추게 할 수 있습니다.

init이 처리하는 한 가지 함정. 헤드리스 모드에서 agy는 ~/.gemini/antigravity-cli/settings.json에 허용 목록이 없으면 모든 MCP 호출을 자동으로 거부합니다. 이 규칙이 없으면 위임은 여전히 실행되지만 조정은 조용히 아무것도 하지 않습니다 — 작동하는 것처럼 보이기 때문에 최악의 실패 유형입니다. init은 mcp(coop/*)를 추가합니다; doctor가 이를 확인합니다.

Antigravity는 자체 스크래치 프로젝트에서 작업합니다. 대상 디렉토리가 작업 공간에 없는 경우입니다. 모든 핸드오프는 --add-dir <cwd>를 전달하고 브리프에 프로젝트 루트를 명시합니다.

설정

수동 설정

도구의 MCP 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "antigravity": {
      "command": "npx",
      "args": ["-y", "antigravity-mcp-server", "--agent", "claude-code"]
    }
  }
}

Antigravity 측에서는 서버 이름을 coop으로 지정하고, --agent antigravity를 사용하며, ~/.gemini/antigravity-cli/settings.json에 다음을 추가하세요:

{ "permissions": { "allow": ["mcp(coop/*)"] } }

서버 키는 허용 규칙과 일치해야 합니다 — 여기서는 coop, 저기서는 mcp(coop/*).

코드 작업

git clone https://github.com/adeelali4/antigravity-mcp
cd antigravity-mcp
npm install

npm test                    # 16 checks, two live stdio clients, no agy credits used
node test/delegation.js     # real end-to-end run (uses agy credits)
node src/cli.js init --local --dry-run

npm test는 한 보드에 대해 별도의 프로세스로 두 개의 실제 MCP 클라이언트를 생성하므로, 프로세스 간 잠금 및 메시징이 실제로(모의되지 않고) 테스트됩니다.

MIT · adeelali4 제작