Descrição
MCP Auditor Local e Arquiteto de Sistema V2 é um servidor de Protocolo de Contexto de Modelo (MCP) de código aberto que revisa códigos e designs de sistema usando um modelo de linguagem que roda inteiramente na máquina do desenvolvedor. Ele se conecta a qualquer cliente compatível com MCP e entrega cada submissão a um servidor LM Studio local em vez de uma API na nuvem, de modo que nenhum código ou design saia da máquina e não há custo por token.
Ler mais
O servidor detecta automaticamente se uma submissão recebida é código ou uma especificação de alto nível e a direciona para um dos dois papéis. No modo Auditor de Código de Produção, ele verifica a entrada contra dez regras de engenharia defensiva que cobrem lógica e condições extremas, como verificações de nulo e divisão por zero, vazamentos de recursos e problemas de desempenho, como gerenciadores de contexto não fechados, e limites defensivos, como dicas de tipo e guardas de loop limitados. Ele retorna um veredicto DETERMINÍSTICO APROVADO ou REJEITADO com feedback acionável. No modo Arquiteto de Sistema e Estrategista, ativado quando a entrada parece uma especificação em vez de código, ele produz topologias de componentes, estruturas de diretórios, modelagem de riscos para concorrência e pontos de falha, e um plano de execução em fases.
Antes que qualquer coisa chegue ao modelo de linguagem, um sentinela rápido baseado em AST analisa a submissão e bloqueia chamadas de alto risco, como eval, exec, os.system e subprocess, e rejeita Python malformado imediatamente. Cada auditoria é registrada duas vezes: como linhas estruturadas em um banco de dados SQLite local para métricas e histórico, e como logs JSON atômicos destinados a servir como um conjunto de dados para ajuste fino. Um script de observador separado pode ser executado ao lado do servidor e postar atualizações de status formatadas em um canal do Discord à medida que novos arquivos de auditoria aparecem, permitindo que uma equipe acompanhe a atividade de revisão sem abrir um painel. O servidor também consulta diretamente o endpoint do modelo ativo do LM Studio, de modo que ele capte qual modelo está atualmente carregado, em vez de exigir um nome de modelo codificado.
O projeto inclui um trecho pronto do "Protocolo de Loop do Agente" que os desenvolvedores podem colar na configuração do assistente de codificação, instruindo o assistente a chamar a ferramenta de auditoria após cada alteração de código, ler o feedback de rejeição, corrigir os problemas relatados e reenviar, limitado a cinco tentativas.
É construído para desenvolvedores individuais e pequenas equipes que desejam uma etapa automatizada de revisão de código e arquitetura em seu fluxo de trabalho de codificação baseado em MCP, sem pagar por inferência na nuvem ou expor código proprietário a uma API de terceiros. Requer Python 3.10 ou posterior, uma instância do LM Studio em execução com um modelo ajustado por instrução carregado, e um cliente compatível com MCP. O projeto é distribuído sob a licença MIT e é gratuito para uso; o mantenedor aceita doações opcionais através do Ko-fi e do GitHub Sponsors.
- CategoriaRevisão de código e testes com IA
- Modelo de preçosCódigo aberto
- ImplantaçãoRoda localmente
- PlataformasWindows, macOS, Linux
Recursos principais de MCP Auditor Local e Arquiteto de Sistema V2
Servidor MCP em modo duplo que detecta automaticamente a entrada de código versus especificação e a direciona para o papel de auditoria correspondente
Modo Auditor de Código de Produção verifica submissões contra 10 regras de engenharia defensiva com um veredicto DETERMINÍSTICO APROVADO/REJEITADO
Modo Arquiteto de Sistema e Estrategista elabora topologias de componentes, modelos de risco e planos de execução em fases a partir de especificações
Sentinela baseado em AST bloqueia chamadas eval, exec, os.system e subprocess, e rejeita Python malformado antes que chegue ao modelo
Executa inteiramente em um servidor LM Studio local, de modo que nenhum código saia da máquina do desenvolvedor e não há custo por token
Descoberta dinâmica de modelo lê qual modelo está atualmente carregado no LM Studio
Registra cada auditoria em um banco de dados SQLite local e em arquivos JSON atômicos adequados para conjuntos de dados de ajuste fino
Observador do Discord em segundo plano posta atualizações formatadas em tempo real quando novos resultados de auditoria são escritos
Inclui um trecho de prompt do "Protocolo de Loop do Agente" que faz um assistente de codificação se autocorrigir através de ciclos repetidos de auditoria e correção
Inclui um conjunto de testes pytest que valida a guarda AST, migrações de banco de dados e pipeline de inferência sem uma instância ativa do LM Studio
Primeiros passos com MCP Auditor Local e Arquiteto de Sistema V2
Instale o LM Studio: Baixe o LM Studio, carregue um modelo ajustado por instrução e inicie seu servidor local na porta 1234.
Clone e configure o servidor: Clone o repositório, crie um ambiente virtual e instale as dependências com pip.
Registre o servidor MCP: Adicione o caminho do script de ponte do servidor ao arquivo de configuração mcpServers do seu cliente MCP.
Execute uma auditoria: Submeta código ou uma especificação através da ferramenta de auditoria; o servidor automaticamente escolhe o modo Auditor de Código ou Arquiteto.
Revise o veredicto: Leia o status APROVADO ou REJEITADO e o feedback, então corrija e reenvie se rejeitado.
Opcional, observe a atividade: Execute o script de observador para receber notificações do Discord para cada novo resultado de auditoria.
Casos de uso de MCP Auditor Local e Arquiteto de Sistema V2
- Portão de revisão de código local
- Planejamento de arquitetura
- Agente de codificação autocorrigível
- Visibilidade de auditoria da equipe




