JS Development MCP Server

Servidor MCP de Desenvolvimento JS

Um servidor Model Context Protocol (MCP) para melhor desenvolvimento JS/TS. Ele permite

• uso preciso de scripts
• descoberta de ferramentas do projeto
• tarefas em segundo plano aprimoradas

Melhor contexto leva a menos atrito e dificuldade com as ferramentas do projeto.

Aviso: Usar isso tem um fator de vibração YOLO de código arbitrário de 8/10 – Sem garantia se isso quebrar seu projeto, computador ou sua vida, mas provavelmente não vai. Não deixe seus agentes sem supervisão. Este servidor permite que você execute scripts npm no copilot do VSCode sem aprovação manual de comandos no terminal toda vez, então tenha cuidado.

Início Rápido

npx js-mcp

Para VSCode / Claude Desktop:

{
  "mcpServers": {
    "js-mcp": {
      "command": "npx",
      "args": ["js-mcp"]
    }
  }
}

Instruções para Agentes LLM e Assistentes de IA

🤖 Instruções para Agentes em Projetos JS/TS

Em projetos Javascript ou Typescript, PREFIRA USAR FERRAMENTAS EM VEZ DE COMANDOS DE TERMINAL:

• npm test → run-tests (detecção de framework, melhores erros)
• npm run build → build-project (detecção de otimização)
• npm install → install-deps (detecta automaticamente npm/yarn/pnpm)
• npm run <script> → run-script (detecção de segundo plano, suporte a argumentos)
• Verificar package.json → list-scripts ou project-status

Benefícios: Sem prompts de aprovação no terminal, contexto de erro aprimorado, consciência de framework, gerenciamento adequado de tarefas em segundo plano.

Fluxo de trabalho: Comece com get-help para orientação, use project-status para projetos desconhecidos, depois use ferramentas específicas.

Ferramentas

1. get-help - Obtenha recomendações inteligentes sobre quais ferramentas usar
2. run-tests - Execute testes do projeto com detecção de framework e melhores erros
3. build-project - Compile projetos com detecção de otimização e consciência de framework
4. install-deps - Instale dependências com gerenciador de pacotes detectado automaticamente (npm/yarn/pnpm)
5. run-script - Execute scripts npm com detecção de segundo plano e suporte a argumentos
6. list-scripts - Liste e categorize todos os scripts npm disponíveis
7. project-status - Verifique a saúde abrangente do projeto e a detecção de framework

Principais Recursos

• Detecção de Framework: Next.js, React, Vue.js, Express, NestJS e mais
• Gerenciamento de Tarefas em Segundo Plano: Detecção automática para servidores de desenvolvimento, controle manual, captura de saída
• Tratamento Inteligente de Erros: Sugestões contextuais e verificação de dependências
• Detecção de Gerenciador de Pacotes: Detecta automaticamente npm, yarn ou pnpm a partir de arquivos de bloqueio
• Suporte a Timeout Personalizado: Configure timeouts (1s-5m) para comandos de longa duração, com padrões inteligentes

Detecção Automática de Tarefas em Segundo Plano

Sempre em Segundo Plano: Scripts contendo dev, start, serve, watch
Nunca em Segundo Plano: Scripts começando com cleanup, clean, reset, install, build, compile, bundle, lint, format, test, deploy, publish, release, prepare, verify, check, validate, audit, update, upgrade, migration, migrate, seed, init, setup, config

Desenvolvimento

Desenvolvimento local:

git clone <repo>
npm install
npm run build
npm start

Licença

Licença GPL-3.0

Contribuindo

Pode contribuir. Sinta-se à vontade para estender este projeto com ferramentas adicionais conforme necessário. Não posso prometer revisar ou mesclar PRs. Este código é um presente, não um compromisso.