{"type": "text"}

Мост субагентов Antigravity (FastMCP)

Контейнеризованный FastMCP сервер, который предоставляет Google Antigravity CLI (agy --headless) как удаленные инструменты Model Context Protocol (MCP) через SSE.

Этот мост позволяет разговорным AI-клиентам (таким как Google Spark, Claude, Cursor или ChatGPT) отправлять полноценные субагенты для кодирования и автоматизации в изолированном контейнеризованном рабочем пространстве.

🚀 Ключевые возможности

• Синхронное выполнение субагента (execute_antigravity_sync): Отправляет задачу кодирования/автоматизации напрямую в agy --headless и возвращает журнал вывода после завершения агента (идеально для коротких задач на 1–3 минуты).

• Асинхронное фоновое выполнение (start_antigravity_async): Запускает долго работающего агента Antigravity в фоновом режиме, возвращая task_id для развязанного выполнения.

• Опрос и управление задачами (get_antigravity_task_status, list_antigravity_tasks): Опрашивает прогресс, просматривает журналы и перечисляет все фоновые субагенты.

• Изоляция рабочего пространства и песочница: Запускается в Docker-контейнере, монтирующем только ./workspaces, защищая файлы хост-системы и предоставляя агенту полную автономию для сборки, тестирования и выполнения внутри его песочницы.

• Бесшовная интеграция с mcp-server-oauth-proxy: Предоставляет стандартные SSE-конечные точки на порту 8080/sse, подключаемые напрямую к OAuth-прокси Home Assistant для безопасного доступа из Google Spark.

Related MCP server: agy-mcp

🛠️ Структура репозитория

antigravity-mcp-bridge/
├── Dockerfile              # Container image with Python 3.12, Node.js, git, & agy CLI
├── docker-compose.yml      # Service definitions with volume mounts & port bindings
├── requirements.txt        # fastmcp, mcp[cli], pydantic
├── server.py               # FastMCP Server exposing Antigravity agent tools
├── .env.example            # Environment variable template
├── .gitignore              # Ignored artifacts & workspace directories
└── README.md               # Documentation

📦 Быстрый старт и развертывание

1. Настройка окружения

Скопируйте шаблон .env.example:

cp .env.example .env

(Необязательно: добавьте ваш GEMINI_API_KEY или ANTIGRAVITY_API_KEY, если это требуется вашим окружением agy).

2. Запуск с помощью Docker Compose

docker compose up -d --build

Сервер FastMCP начнет прослушивание на: 👉 http://localhost:8080/sse (или IP-адрес вашей локальной сети).

3. Проверка работоспособности контейнера

docker compose logs -f

🔗 Подключение к mcp-server-oauth-proxy

Чтобы безопасно предоставить этот мост субагентов Antigravity для Google Spark через ваш OAuth-прокси Home Assistant:

1. В Home Assistant откройте Настройки > Дополнения > MCP Server OAuth Proxy > Конфигурация.

2. Добавьте новую запись сервера в разделе servers:

    - client_name: "Google Spark"
      server_name: "Antigravity Bridge"
      server_url: "http://<YOUR_DOCKER_HOST_IP>:8080/sse"
      bearer_token: ""
      client_id: "spark-antigravity"
      client_secret: "secret-antigravity"
      allowed_redirect_uris: "https://oauth-redirect.googleusercontent.com"
      host: "antigravity-oauth.yourdomain.com"
      path_prefix: ""

3. Сохраните и перезапустите дополнение.

4. В Google Spark добавьте пользовательский инструмент, указывающий на https://antigravity-oauth.yourdomain.com/sse с Client ID spark-antigravity.

🧰 Доступные MCP-инструменты

1. execute_antigravity_sync

• Описание: Выполняет задачу синхронно через agy --headless и ожидает вывода.

• Параметры:

  • prompt (строка, обязательный): Цель или инструкция по кодированию.

  • sub_path (строка, необязательный): Подкаталог в /workspace для выполнения.

  • timeout_seconds (целое, по умолчанию: 300): Максимальное количество секунд ожидания перед прерыванием.

2. start_antigravity_async

• Описание: Запускает задачу Antigravity в фоновом режиме и возвращает task_id.

• Параметры:

  • prompt (строка, обязательный): Цель или инструкция по кодированию.

  • sub_path (строка, необязательный): Подкаталог в /workspace для выполнения.

3. get_antigravity_task_status

• Описание: Проверяет прогресс и полные журналы фоновой задачи.

• Параметры:

  • task_id (строка, обязательный): 8-символьный идентификатор, возвращаемый start_antigravity_async.

4. list_antigravity_tasks

• Описание: Перечисляет все активные и завершенные фоновые задачи.

{"type": "text"}