# Antigravity MCP Server 🚀

[Русское описание ниже](#russian-description)

This project is a **Model Context Protocol (MCP)** server that acts as a bridge between the [Google Antigravity CLI (agy)](https://antigravity.google) and various MCP clients (Claude Desktop, Cursor, Windsurf, Cline, etc.).

By using this server, you can empower your AI assistant with the advanced capabilities of Google Antigravity directly inside your favorite IDE.

---

## ✨ Features

This server provides **13 specialized tools** powered by the Antigravity TUI/CLI ecosystem. Here are the core capabilities:

### Core & Productivity
- **`agy_task`**: Execute arbitrary prompts using the Antigravity agent. Perfect for writing code, refactoring, or answering technical questions.
- **`agy_chat`**: Resume and manage conversational threads with context memory (`--continue` or `--conversation`).
- **`agy_notebook_query`**: Local RAG agent acting like Google NotebookLM for querying specific directories using `--add-dir`.

### Code & Git
- **`agy_analyze`**: Deep architectural review of files or folders.
- **`agy_refactor` / `agy_generate_tests` / `agy_explain_error`**: Developer-focused code tools for fast rewrites, test creation, and debugging compiler stack traces.

### Advanced Automation
- **`agy_autonomous_agent`**: Fully autonomous execution (YOLO mode) using the `--dangerously-skip-permissions` flag and `--mode accept-edits`.
- **`agy_sandbox_agent`**: Runs commands inside a restricted sandbox environment using the `--sandbox` flag.
- **`agy_security_audit`**: Strict security and logic audit (OWASP rules, XSS, SSRF, credential leaks) ignoring minor stylistic complaints.

### CLI Metadata
- **`agy_get_models`**: Retrieve the list of active Vertex AI/Gemini models configured in `agy`.
- **`agy_get_agents`**: List available subagents and custom profiles.
- **`agy_get_changelog`**: Show release notes of the installed CLI.

---

## 🛠 Prerequisites

*   **Node.js**: Version 18 or higher.
*   **Antigravity CLI**: Must be installed and authorized (`agy` command should be accessible in the terminal).

---

## 🚀 Installation

1. Clone or copy this repository files to your local drive.
2. Run the automated configuration script for your OS:
   - **Windows:** Double-click `setup.bat`
   - **macOS:** Double-click `setup.command`
   - **Linux:** Run `./setup.sh` in the terminal
   
   These scripts will automatically install npm packages, verify your `agy` installation, and generate a customized config JSON (`mcp_config_generated.json`) with absolute paths for easy copy-pasting.

---

## ⚙️ Configuration for MCP Clients

### 1. Claude Desktop
Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "antigravity-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/antigravity-mcp/index.js"
      ]
    }
  }
}
```

### 2. Cursor (IDE)
1. Go to **Settings** -> **Cursor Settings** -> **General** -> **MCP**.
2. Click **+ Add Server**.
3. Name: `antigravity-mcp`.
4. Type: `command`.
5. Command: `node "/absolute/path/to/antigravity-mcp/index.js"`.

---

<a name="russian-description"></a>
# Antigravity MCP Server (На русском) 🇷🇺

Этот проект представляет собой сервер **Model Context Protocol (MCP)**, который выступает в роли моста между [Google Antigravity CLI (agy)](https://antigravity.google) и различными MCP-клиентами (Claude Desktop, Cursor, Windsurf, Cline и др.).

## ✨ Возможности

Сервер предоставляет **13 специализированных инструментов**:

### Базовые и продуктивные
- **`agy_task`**: Выполнение произвольных запросов через ассистента Antigravity.
- **`agy_chat`**: Диалог с сохранением контекста и переключением веток переписки.
- **`agy_notebook_query`**: Локальный RAG-агент (аналог NotebookLM) по вашим локальным папкам.

### Код и Git
- **`agy_analyze`**: Архитектурный анализ исходного кода файлов или целых каталогов.
- **`agy_refactor` / `agy_generate_tests` / `agy_explain_error`**: Утилиты для быстрого рефакторинга, генерации модульных тестов и объяснения стектрейсов ошибок.

### Автономные агенты
- **`agy_autonomous_agent`**: Запуск агента в режиме полной автономии (YOLO) с флагом `--dangerously-skip-permissions` (модель сама принимает и применяет правки кода в режиме `--mode accept-edits`).
- **`agy_sandbox_agent`**: Запуск задач в безопасной изолированной песочнице с помощью флага `--sandbox`.
- **`agy_security_audit`**: Строгий аудит безопасности кода без мелких придирок к стилю (поиск OWASP-уязвимостей, XSS, инъекций, секретов).

### Системные метаданные
- **`agy_get_models`**: Вывод списка доступных моделей.
- **`agy_get_agents`**: Вывод списка настроенных профилей ИИ-ассистентов.
- **`agy_get_changelog`**: Чтение истории обновлений CLI.

---

## 🚀 Установка

1. Скачайте файлы проекта.
2. Запустите скрипт автоматической настройки из папки проекта:
   - **Windows:** Запустите `setup.bat` (двойным кликом)
   - **macOS:** Запустите `setup.command` (двойным кликом)
   - **Linux:** Выполните `./setup.sh` в терминале
   
   Скрипты автоматически выполнят `npm install`, проверят статус `agy` и сгенерируют персональный файл настроек `mcp_config_generated.json` с абсолютными путями для вашей ОС.

---

## 📝 License / Лицензия

MIT