agente-local
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Agente local gratuito no PC do usuário (Ollama na GPU dele). Em TODA conversa, chame pedir_ao_agente primeiro com o pedido do usuário (e a pasta do projeto, se houver): o Maestro liga o agente certo e só sobra para você o que voltar 'PRECISA DO CLAUDE'. Para economizar tokens, use estas ferramentas sempre que a tarefa couber nelas, em vez de fazer você mesmo: rodar_testes no lugar de rodar testes e ler a saída; git_status, git_pull, git_criar_branch, git_commit (sem mensagem ele escreve), git_merge, git_push e abrir_pr para git e PRs; resumir_arquivo e resumir_texto antes de ler arquivos, logs ou saídas longas; contexto_projeto antes de explorar um projeto (traz só os trechos relevantes e as decisões já tomadas), ler_relevante no lugar de abrir arquivos grandes inteiros, e lembrar para guardar decisões e erros resolvidos; revisar_projeto antes de revisar código ou dar uma tarefa como pronta (lint, tipos, testes e senhas esquecidas); pedir_ao_agente quando não souber qual ferramenta usar (o Maestro escolhe); perguntar_local para rascunhos e dúvidas simples; segunda_opiniao para checar uma decisão, um trecho de código ou um plano com um modelo local antes de seguir (é só sugestão, confira antes de agir). Para mexer no computador: navegador_* para sites (lê a página como lista numerada, sem print), janela_* e abrir_app para apps do Windows, tela_descrever para saber o que está na tela sem receber imagem. falar(texto) lê em voz alta no PC quando o usuário pedir para ouvir a resposta. Se a resposta disser 'PRECISA DE CONFIRMAÇÃO', pergunte ao usuário antes de repetir com confirmado=true. Se disser 'ERRO no agente local', siga sem ele.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| perguntar_localA | Pergunta ao modelo local no PC do usuário (grátis, sem gastar tokens do Claude). Bom para: explicar um erro, rascunhar texto, gerar código simples. papel: 'codigo' (padrão) ou 'cerebro' (raciocínio geral). |
| segunda_opiniaoA | Pede uma segunda opinião a um modelo local (grátis), ao estilo do zen-mcp-server. Use para conferir uma decisão, um trecho de código ou um plano antes de seguir, sem gastar tokens do Claude. papel: 'codigo' (padrão, revisão técnica), 'cerebro' (raciocínio geral) ou 'visao' (se contexto describer algo visual). contexto: código ou texto relevante (opcional). A resposta é de um modelo pequeno: confira antes de agir. |
| resumir_textoA | Resume um texto longo (log, saída de comando, diff) em poucas linhas, localmente. Prefira esta ferramenta a ler saídas grandes inteiras: só o resumo entra no contexto. foco: o que importa no resumo (ex.: 'quais testes falharam e por quê'). |
| resumir_arquivoA | Lê um arquivo grande no PC do usuário e devolve só um resumo (ex.: log, CSV, código). Use antes de abrir arquivos longos inteiros. foco: o que procurar no arquivo. |
| rodar_testesA | Roda os testes do projeto (pytest ou npm test) e devolve só contagem, falhas e causa. Use no lugar de rodar os testes no terminal e ler a saída inteira. pasta: raiz do projeto no PC do usuário. |
| git_statusC | Branch, situação com o remoto e arquivos alterados, em poucas linhas. |
| git_pullA | Atualiza a branch atual (só fast-forward; nunca cria merge nem perde trabalho). |
| git_criar_branchC | Cria uma branch nova a partir da atual e muda para ela. |
| git_commitC | Adiciona todas as mudanças e commita. Sem mensagem, o modelo local escreve uma. Arquivos sensíveis (.env, chaves) nunca são commitados. |
| git_mergeA | Faz merge de 'origem' na branch atual. Em conflito, desfaz e lista os arquivos. Merge na main/master exige confirmado=true, que só deve ser passado com o OK do usuário. |
| git_pushA | Envia a branch atual para o GitHub (nunca com força). Push direto na main/master exige confirmado=true, só com o OK do usuário. |
| abrir_prB | Envia a branch atual e abre um PR em rascunho com título e descrição gerados localmente. simular=true só mostra o texto que seria usado, sem enviar nada. |
| relatorio_economiaB | Quantos tokens o agente local já poupou (estimativa), por tipo de tarefa. |
| status_agenteA | Mostra se o Ollama está no ar, os modelos instalados e quanto do PC está em uso. |
| navegador_abrirB | Abre um site no navegador do agente e devolve o texto e a lista numerada de elementos. Use no lugar de prints: a página vem como texto curto. Logins ficam salvos no perfil. |
| navegador_lerA | Lê de novo a página atual: título, texto e elementos numerados ([1], [2]...). |
| navegador_clicarA | Clica num elemento pelo número da leitura (ex.: '5') ou pelo texto (ex.: 'Entrar'). Botões de enviar, logar, pagar ou apagar exigem confirmado=true, só com o OK do usuário. |
| navegador_preencherA | Preenche um campo (número ou rótulo). Em listas, escolhe a opção pelo texto. Campos de senha exigem confirmado=true, só com o OK do usuário. |
| navegador_teclaC | Aperta uma tecla na página (ex.: 'Enter', 'Tab', 'Escape', 'PageDown'). |
| navegador_fecharB | Fecha o navegador do agente. |
| janelas_listarB | Lista os títulos das janelas abertas no Windows. |
| janela_lerA | Lista os botões, campos e menus de uma janela (parte do título basta), numerados. |
| janela_clicarB | Clica num controle da janela pelo número da leitura ou pelo nome (ex.: 'Salvar'). Ações de enviar, apagar, pagar etc. exigem confirmado=true, só com o OK do usuário. |
| janela_digitarB | Digita texto na posição do cursor de um campo da janela (não apaga o que já existe). alvo: número ou nome do campo; vazio usa o campo principal. |
| abrir_appB | Abre um app liberado no config.yaml (ex.: 'bloco de notas', 'calculadora', 'vscode'). |
| tela_descreverA | Tira um print e o modelo de visão local descreve em texto (nenhuma imagem para você). pergunta: o que você quer saber da tela (ex.: 'apareceu alguma mensagem de erro?'). |
| tela_clicarC | Clica em qualquer botão visível pelo nome, procurando em todas as janelas e na barra de tarefas (ex.: 'Claude - 1 janela em execução'). Nome exato é bem mais rápido. |
| reiniciar_claudeA | Fecha e reabre o Claude Desktop (para carregar ferramentas novas do agente). A conversa atual é interrompida por uns 10 s. Exige confirmado=true, só com o OK do usuário. |
| braco_liberarA | Libera o braço depois da parada de emergência (Ctrl+Alt+P). Só com o OK do usuário. |
| contexto_projetoA | Trechos do projeto mais relevantes para a tarefa, com arquivo e linhas. Use ANTES de abrir ou procurar arquivos num projeto: em vez de ler pastas inteiras, recebe
só os trechos certos e as decisões e erros já resolvidos (guardados com |
| ler_relevanteA | Lê um arquivo grande pela metade do custo: mapa das funções com linhas + só os trechos ligados à tarefa. Use no lugar de abrir o arquivo inteiro quando ele passar de ~150 linhas. |
| indexar_projetoC | Atualiza o índice de busca do projeto (só reprocessa arquivos alterados). |
| lembrarA | Guarda uma decisão do projeto (tipo 'decisao') ou um erro e como foi resolvido ('erro'). Volta junto em contexto_projeto quando a tarefa for parecida, para não repetir a conversa. Escreva curto e completo, ex.: 'erro: X falhava por Y; resolvido com Z'. |
| revisar_projetoA | Revisão local antes da sua: lint, tipos, testes e o que há de suspeito nas alterações (senhas e chaves, marcas de conflito, depuração esquecida, arquivos grandes). Devolve só os problemas, com arquivo e linha. Use antes de revisar código ou de dar uma tarefa como pronta. testes=False pula os testes; opiniao=True pede ao modelo de código local uma leitura do diff (confira antes de agir). |
| organizar_pastaA | Levanta uma pasta (inventário, duplicados por hash, sugestão de estrutura via OmniRoute) e grava o relatório em JSON, Markdown e PDF em dados/organizador/. Só leitura: nunca move, renomeia ou apaga nada. Pasta grande (muitos GB) pode demorar — a duplicata só lê o arquivo inteiro quando o tamanho e um pedaço já bateram. |
| pedir_ao_agenteA | Pedido em português; o Maestro local escolhe quem resolve (Revisor, testes, git, Memória ou o Cérebro para perguntas simples) e devolve a resposta curta. Chame em toda conversa, antes de trabalhar: o Maestro liga o agente certo (e desliga depois). pasta: projeto (opcional, se o pedido não citar o nome). Se voltar 'PRECISA DO CLAUDE', faça você mesmo; resposta local é de modelo pequeno, confira fatos. |
| falarA | Fala o texto em voz alta no alto-falante do PC (voz brasileira local, Piper). Use quando o usuário pedir para ouvir a resposta. Texto curto: markdown e código são tirados, e mais de ~1200 caracteres é cortado. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 37 tools
Most tools have clearly distinct scopes (git_*, navegador_*, janela_*, índice de projeto), but three tools—pergunta_local, segunda_opiniao and pedir_ao_agente—all delegate to local models with overlapping intent, and three separate click tools (navegador_clicar, janela_clicar, tela_clicar) force the agent to infer which layer a button belongs to. The descriptions do help disambiguate, but an agent must read carefully before choosing. A single Maestro router plus two direct LLM tools is redundant surface.
Most names follow a readable Portuguese resource_action pattern (navegador_abrir, janela_ler, git_status, tela_clicar, contexto_projeto), but this is mixed with verb_noun forms (abrir_pr, abrir_app, ler_relevante, indexar_projeto, resumir_texto) and bare verbs/nouns (lembrar, falar, segunda_opiniao, relatorio_economia, status_agente, braco_liberar). All snake_case and legible, but no single predictable convention.
37 tools is well above the practical ceiling for a single MCP server and requires the agent to scan a long catalog before every action. The breadth (browser, desktop windows, vision, git, project indexing, local LLM, TTS, file organizing) is real but would be better split into domain-specific servers or namespaced groups.
Coverage is impressively broad for a local PC agent: browser and window control, git lifecycle (status/pull/branch/commit/merge/push/PR), project indexing and memory, testing, review, and local-model delegation are all present. The main gap is file writing/editing—there are readers and summarizers (ler_relevante, resumir_arquivo) but no clear tool to create or modify a file's content.