yoyo: Servidor MCP Local para Leituras Fundamentadas de Código e Escritas Protegidas com Claude Code

O que o yoyo faz

yoyo é um servidor MCP local de código aberto projetado para trabalhar em bases de código reais com agentes de codificação, incluindo o Claude Code. A ferramenta foi construída em parte com Claude/Claude Code e foi projetada para ser útil a partir do próprio Claude Code.

Funcionalidades principais

• Leituras fundamentadas do repositório: Fornece aos agentes capacidades como inspect, judge_change e impact
• Escritas protegidas: Impede que edições quebradas sejam aplicadas silenciosamente na base de código
• Feedback estruturado: Retorna uma saída legível por máquina (guard_failure) quando uma escrita falha
• Mecanismo de nova tentativa: Adiciona retry_plan para que a próxima etapa de reparo seja mais restrita e direcionada
• Proteções em tempo de execução: Suporta proteções em tempo de execução para linguagens interpretadas, permitindo que arquivos sejam revertidos se forem analisados sintaticamente, mas ainda falharem em tempo de execução

Suporte a linguagens

Atualmente suporta 16 linguagens: Rust, Go, Python, TypeScript, JavaScript, C, C++, C#, Clojure, Java, Kotlin, PHP, Ruby, Swift, Bash e Zig.

Exemplo prático

Uma edição em Python pode passar em uma verificação de sintaxe, mas ainda falhar devido a uma importação ausente ou um nome indefinido. O yoyo pode capturar isso na proteção de tempo de execução, restaurar o arquivo original e retornar um feedback estruturado para a próxima tentativa de correção.

Atualizações recentes

Trabalhos recentes adicionaram suporte inicial ao Clojure e uma inicialização de configuração de tempo de execução com privilégios mínimos.

Disponibilidade

A ferramenta é gratuita para experimentar e de código aberto em https://github.com/avirajkhare00/yoyo.