VSCode Maestro MCP

O servidor MCP mais abrangente para VS Code — mais de 100 ferramentas em 25 categorias. Operações de arquivo, terminal, git, provedores LSP (hover, conclusão, definição, referências) e muito mais. Núcleo gratuito + recursos premium.

Documentação

VSCode Maestro MCP

O servidor MCP mais abrangente para VS Code — mais de 100 ferramentas em 25 categorias, desde operações de arquivos até provedores LSP.

Controle todos os aspectos do VS Code através do Model Context Protocol. Deixe agentes de IA lerem arquivos, executarem comandos, obterem complementos, documentação de hover, referências e muito mais — tudo sem sair do seu editor.

Início Rápido

  1. Instale esta extensão do VS Code Marketplace
  2. O servidor MCP inicia automaticamente na porta 3002
  3. Conecte seu cliente MCP:
{
  "maestro-mcp": {
    "type": "http",
    "url": "http://localhost:3002/mcp"
  }
}
  1. Comece a usar ferramentas — list_files, read_file, execute_hover, etc.

Ferramentas Gratuitas (sem necessidade de licença)

CategoriaFerramentasDescrição
Arquivos8Listar, encontrar, pesquisar, ler, criar, copiar, mover, excluir
Edição3Substituir linhas, inserir texto, desfazer
Terminal3Executar comandos, ler saída, listar terminais
Editor5Foco, informações do espaço de trabalho, canais de saída, comandos do VS Code
Diagnósticos3Erros, avisos, estado do editor
Depuração13Sessões, pontos de interrupção, execução passo a passo, variáveis, pilha de chamadas
Git9Status, diff, log, blame, commit, branch, stash
Seleção6Obter/substituir seleção, cursor, área de transferência
Diff2Comparar arquivos, alterações não salvas
Tarefas2Listar e executar tarefas do VS Code
Notificações4Mensagens, caixas de entrada, seleções rápidas, progresso
Configurações5Obter/definir configurações, extensões, atalhos de teclado
Refatoração2Edições no espaço de trabalho, localizar e substituir
Snippets2Inserir e envolver com snippets
Testes7Executar testes, cobertura, resultados
Abas/Layout6Abas, layout, painéis, visualização de markdown

Ferramentas Premium (licença necessária)

Desbloqueie os provedores do Language Server Protocol do VS Code — os mesmos dados que alimentam o IntelliSense, acessíveis a qualquer cliente MCP.

CategoriaFerramentasDescrição
Complemento1Complemento de código em qualquer posição
Hover1Informações de hover (documentação, tipos)
Assinatura1Ajuda de assinatura de função
Ações de Código2Correções rápidas, refatorações, CodeLens
Navegação3Ir para definição, referências, hierarquia de chamadas
Símbolos2Pesquisa de símbolos no documento e no espaço de trabalho
Formatação2Formatação de documento, renomear símbolo
Semântico2Tokens semânticos, dicas inlay
Recursos de Documento3Links de documento, seletor de cores, intervalos de dobra

Obtenha uma licença — compra única, sem assinatura.

Carregamento Dinâmico de Ferramentas

As ferramentas são organizadas em categorias que podem ser habilitadas/desabilitadas em tempo de execução usando a ferramenta manage_tool_categories. Categorias premium exigem uma chave de licença válida. Quando as categorias mudam, o servidor MCP envia notificações toolListChanged para que os clientes atualizem automaticamente suas ferramentas disponíveis.

Configuração

ConfiguraçãoPadrãoDescrição
maestroMcp.port3002Porta do servidor MCP
maestroMcp.host127.0.0.1Host do servidor MCP
maestroMcp.autoStarttrueIniciar servidor na ativação
maestroMcp.licenseKey""Chave de licença premium

Comandos

  • Maestro MCP: Toggle Server — Iniciar/parar o servidor MCP
  • Maestro MCP: Show Server Info — Exibir URL e status do servidor
  • Maestro MCP: Enter License Key — Inserir chave de licença premium
  • Maestro MCP: License Status — Verificar status atual da licença

Compatibilidade

Funciona com qualquer cliente MCP que suporte transporte HTTP Streamable:

Requisitos

  • VS Code 1.85.0 ou posterior

Licença

Recursos principais gratuitos. Recursos LSP premium exigem uma licença.

Consulte LICENSE.md para obter detalhes.