JS Development MCP Server

JS Development MCP Server

Un servidor de Model Context Protocol (MCP) para un mejor desarrollo JS/TS. Permite

• uso preciso de scripts
• descubrimiento de herramientas del proyecto
• mejora de tareas en segundo plano

Un mejor contexto conlleva menos fricción y dificultades con las herramientas del proyecto.

Advertencia: Usar esto tiene un factor de codificación estilo YOLO de 8/10 arbitrario – Sin garantía si esto rompe tu proyecto, tu ordenador o tu vida, pero probablemente no lo hará. No dejes a tus agentes sin supervisión. Este servidor te permite ejecutar scripts npm en VSCode copilot sin aprobación manual de comandos de terminal cada vez, así que ten cuidado.

Inicio Rápido

npx js-mcp

Para VSCode / Claude Desktop:

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

Instrucciones para Agentes LLM y Asistentes de IA

🤖 Instrucciones para Agentes en Proyectos JS/TS

En proyectos Javascript o Typescript, PREFIERE USAR HERRAMIENTAS EN LUGAR DE COMANDOS DE TERMINAL:

• npm test → run-tests (detección de frameworks, mejores errores)
• npm run build → build-project (detección de optimización)
• npm install → install-deps (auto-detecta npm/yarn/pnpm)
• npm run <script> → run-script (detección de segundo plano, soporte de argumentos)
• Comprobar package.json → list-scripts o project-status

Beneficios: Sin avisos de aprobación de terminal, contexto de errores mejorado, conocimiento de frameworks, gestión adecuada de tareas en segundo plano.

Flujo de trabajo: Comienza con get-help para obtener orientación, usa project-status para proyectos desconocidos, y luego usa herramientas específicas.

Herramientas

1. get-help - Obtén recomendaciones inteligentes sobre qué herramientas usar
2. run-tests - Ejecuta pruebas del proyecto con detección de frameworks y mejores errores
3. build-project - Compila proyectos con detección de optimización y conocimiento de frameworks
4. install-deps - Instala dependencias con gestor de paquetes auto-detectado (npm/yarn/pnpm)
5. run-script - Ejecuta scripts npm con detección de segundo plano y soporte de argumentos
6. list-scripts - Lista y categoriza todos los scripts npm disponibles
7. project-status - Comprueba el estado integral del proyecto y la detección de frameworks

Características Clave

• Detección de Frameworks: Next.js, React, Vue.js, Express, NestJS y más
• Gestión de Tareas en Segundo Plano: Auto-detección para servidores de desarrollo, control manual, captura de salida
• Manejo Inteligente de Errores: Sugerencias contextuales y comprobación de dependencias
• Detección de Gestor de Paquetes: Auto-detecta npm, yarn o pnpm a partir de archivos de bloqueo
• Soporte de Timeout Personalizado: Configura timeouts (1s-5m) para comandos de larga duración, con valores predeterminados inteligentes

Auto-Detección de Tareas en Segundo Plano

Siempre en Segundo Plano: Scripts que contienen dev, start, serve, watch
Nunca en Segundo Plano: Scripts que comienzan con 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

Desarrollo

Desarrollo local:

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

Licencia

Licencia GPL-3.0

Contribuciones

Adelante. Siéntete libre de ampliar este proyecto con herramientas adicionales según sea necesario. No puedo prometer revisar o fusionar PRs. Este código es un regalo, no un compromiso.