convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
rauls-kjarners

Claude-to-Agy MCP Bridge

rauls-kjarners/claude-to-agy

Bridge MCP para delegar tarefas pesadas do Claude ao Antigravity CLI

Ver no GitHub
BomPluginScore · de 0 a 100

Um 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-agy

1 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

Estrelas
12
Forks
1
Acompanhando
1
Saúde
42%
Último commit
há 5 meses
Versão
v1.1.1
Issues abertas
1
Contribuidores
1

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

CI codecov

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

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.md per project, add the rules to ~/.claude/CLAUDE.md instead.

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:

VariableDefaultDescription
AGY_CONNECT_TIMEOUT60Seconds to start the agy process
AGY_TOTAL_TIMEOUT1200Hard timeout for entire execution

How It Works

User → Claude Code → MCP bridge (FastMCP) → agy CLI → Gemini API
                   ←                      ←         ←
  1. CLAUDE.md instructs Claude when to delegate
  2. Claude calls delegate_to_agy(prompt, cwd, files?) via MCP
  3. bridge.py prepends file paths to the prompt
  4. Runs agy --dangerously-skip-permissions --add-dir <cwd> -p "<prompt>"
  5. 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

Ver o original no GitHub

Bom para

Relacionados