Antigravity MCP Bridge (Antigravity 2.0 ↔ Gemini Spark)

Программное управление агентами Google Antigravity 2.0 на Windows через Gemini Spark и удалённые/локальные MCP-клиенты по транспорту Streamable HTTP и stdio.

Обзор архитектуры

Gemini Spark (or Remote MCP Client)
      │
      │ HTTPS Request (Authorization: Bearer <MCP_AUTH_TOKEN>)
      ▼
Tailscale Funnel (Public HTTPS: https://<node>.<tailnet>.ts.net/mcp)
      │
      │ Encrypted Local Tunnel
      ▼
Streamable HTTP MCP Server (src/http_server.py on 127.0.0.1:8000)
      │
      ├── AuthMiddleware (Validates MCP_AUTH_TOKEN -> 401 Unauthorized if invalid)
      ├── /health & /healthz Diagnostic Endpoints
      │
      ▼
FastMCP Core Server (src/server.py - Streamable HTTP & stdio)
      │
      ├── launch_antigravity_agent
      ├── get_session_status
      ├── list_workspace_artifacts
      └── run_antigravity_cli_command
      │
      ▼
Antigravity Bridge Adapter -> agentapi.bat -> Antigravity 2.0 Runtime -> Local Workspace

Related MCP server: tailscale-mcp

Быстрый старт (однокликовые операции в Windows)

• START.bat: инициализирует окружение, создаёт .env с защищённым токеном аутентификации, запускает фоновый HTTP-сервер на 127.0.0.1:8000, включает Tailscale Funnel и отображает баннер подключения.

• STATUS.bat: проверяет работоспособность сервера в реальном времени, статус PID, состояние токена аутентификации, статус входа в Tailscale и Funnel, а также доступность среды выполнения Antigravity.

• STOP.bat: корректно завершает процесс HTTP MCP-сервера и отключает сопоставление Tailscale Funnel.

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

1. Поддержка двух транспортов:

   • Транспорт stdio для локальных MCP-клиентов (python src/server.py).

   • Транспорт Streamable HTTP для Gemini Spark и удалённых клиентов (START.bat / python -m src.http_server).

2. Аутентификация и защита токеном:

   • AuthMiddleware, обеспечивающий проверку токена на /mcp.

   • Поддержка Authorization: Bearer <token>, x-api-key: <token> или ?token=<token>.

   • Автоматическая генерация 32-символьного hex-токена при его отсутствии в .env.

3. Интеграция с Tailscale Funnel:

   • Защищённая публичная HTTPS-конечная точка без покупки домена.

   • Надёжное обнаружение, отчёт о статусе и рекомендации по устранению неполадок при отсутствии или отключении Tailscale.

4. Локальный движок Antigravity 2.0:

   • Интеграция без настройки с локальным языковым сервером Antigravity через agentapi.bat.

5. Безопасность и изоляция рабочей области:

   • Проверка границ рабочей области, предотвращающая атаки с обходом пути.

   • Автоматическое редактирование секретных ключей и токенов в выходных потоках.

   • Блокировка одновременного выполнения в рабочей области, предотвращающая конфликты нескольких агентов.

Предоставляемые MCP-инструменты

• launch_antigravity_agent: запускает задачу агента Antigravity, нацеленную на локальную рабочую область.

• get_session_status: проверяет статус сеанса, временные метки и актуальные метаданные.

• list_workspace_artifacts: индексирует файлы, размеры, временные метки и SHA256-хэши в рабочей области.

• run_antigravity_cli_command: выполняет поддерживаемые подкоманды agentapi (get-conversation-metadata, send-message, new-conversation).

Проверка и набор тестов

Запуск полного набора автоматизированных модульных и интеграционных тестов:

.venv\Scripts\python.exe -m pytest tests/

Запуск реального сквозного HTTP MCP-интеграционного теста:

.venv\Scripts\python.exe remote_smoke_test.py

Запуск локального смоук-теста stdio:

.venv\Scripts\python.exe smoke_test.py

Документация

Подробная документация доступна в docs/:

• docs/remote-access.md: полное руководство по удалённому доступу, Tailscale Funnel и подключению Gemini Spark.

• docs/mcp-setup.md: фрагменты конфигурации клиента для Gemini Spark и Antigravity IDE.

• docs/security.md: модель безопасности, проверка путей и правила редактирования секретов.

• docs/troubleshooting.md: матрица устранения неполадок и шаги диагностического восстановления.

• FINAL-REPORT.md: полный отчёт о статусе интеграции и эмпирическая матрица проверки.