Claude-to-Agy MCP Bridge
rauls-kjarners/claude-to-agy
Bridge MCP para delegar tarefas pesadas do Claude ao Antigravity CLI
Ver no GitHubUm servidor MCP leve que permite ao Claude Code delegar tarefas pesadas para a CLI Antigravity, economizando janela de contexto e tokens. Automaticamente identifica e processa arquivos grandes, análises multi-arquivo, buscas profundas e revisões adversariais.
Instalação
npx convez-ai rauls-kjarners/claude-to-agy1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Processar arquivos grandes (>200 linhas) sem consumir contexto
- Análise simultânea de múltiplos arquivos (>3 arquivos)
- Buscas profundas em logs, git diff e documentação
Veredito

Solução prática para otimizar uso de contexto em Claude Code, mas requer Antigravity CLI instalado e autenticado. Bem estruturado com testes e documentação clara, ideal para fluxos de desenvolvimento que lidam com bases de código grandes.
README
A tradução para o português deste README ainda está na fila.
claude-to-agy
A lightweight MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) - saving context window and tokens for what matters.
What It Does
Registers a delegate_to_agy MCP tool that Claude automatically uses when it encounters:
- Large files (>200 lines) - logs, dumps, generated code
- Multi-file analysis (>3 files at once)
- Deep searches -
git log,git diff,grep - Web lookups - documentation, external knowledge
- Adversarial review / plan critique - always delegated
Claude sends a prompt + file paths → the bridge runs agy CLI → returns the result.
Requirements
- Python 3.10+
agyCLI installed and authenticated- Claude Code
Installation
# 1. Register the MCP server globally via uvx
claude mcp add -s user claude-to-agy uvx claude-to-agy
# 2. Download the delegation rules into your current project
curl -o CLAUDE.md https://raw.githubusercontent.com/rauls-kjarners/claude-to-agy/main/CLAUDE.md
That's it. Claude will now automatically delegate heavy tasks to Antigravity CLI in any project that has the CLAUDE.md file.
Tip: To enable globally without copying
CLAUDE.mdper project, add the rules to~/.claude/CLAUDE.mdinstead.
Using as a Skill
This project also includes a SKILL.md file, which is the standard format for reusable Claude Code skills. If your setup supports skills, you can use it instead of manually copying CLAUDE.md:
claude skill add https://raw.githubusercontent.com/rauls-kjarners/claude-to-agy/main/SKILL.md
Note: You still need the MCP server registered (step 1 above). The skill provides the rules, MCP provides the tool.
Configuration
All settings are optional environment variables:
| Variable | Default | Description |
|---|---|---|
AGY_CONNECT_TIMEOUT | 60 | Seconds to start the agy process |
AGY_TOTAL_TIMEOUT | 1200 | Hard timeout for entire execution |
How It Works
User → Claude Code → MCP bridge (FastMCP) → agy CLI → Gemini API
← ← ←
CLAUDE.mdinstructs Claude when to delegate- Claude calls
delegate_to_agy(prompt, cwd, files?)via MCP bridge.pyprepends file paths to the prompt- Runs
agy --dangerously-skip-permissions --add-dir <cwd> -p "<prompt>" - Returns the text output cleanly or raises an exception natively handled by FastMCP
Development
# Linting & Formatting
uv run ruff check .
uv run ruff format .
# Type Checking
uv run pyright
# Tests
uv run pytest
# Pre-commit Hooks (Run before committing)
uv run pre-commit install
License
MIT