Proporciona un kit de herramientas para desarrolladores que automatiza la detección de stack, la validación de entornos, la comprobación de conflictos de puertos y la detección de discrepancias en la documentación.
También conocido como WhenLabs-org/when, @whenlabs/when
- Stars
- 4
- Herramientas
- 8
- Descargas, 30 días
- —
- Última versión
- 0.12.3
- Último commit
- 9 nov 2026
- Licencia
- MIT
¿Qué es WhenLabs MCP?
WhenLabs es un MCP server. Proporciona un kit de herramientas para desarrolladores que automatiza la detección de stack, la validación de entornos, la comprobación de conflictos de puertos y la detección de discrepancias en la documentación. Expone 8 herramientas, como aware_sync, berth_check, envalid_validate.
Resumen generado a partir del README del proyecto
Acerca del MCP server de WhenLabs
Este toolkit permite a los desarrolladores automatizar las comprobaciones de salud del proyecto y la validación del entorno dentro de Claude Code. Al instalar el servidor vía npx, integras seis herramientas especializadas en tu flujo de trabajo que Claude puede llamar automáticamente. El proceso de configuración registra el servidor de whenlabs e inyecta un bloque CLAUDE.md para que la IA entienda cómo utilizar los endpoints disponibles.
Los usuarios pueden gestionar su entorno de desarrollo mediante endpoints específicos como berth_check para conflictos de puertos o envalid_validate para verificar archivos .env contra un esquema. El toolkit también incluye stale_scan para encontrar discrepancias en la documentación y vow_scan para comprobar las licencias de las dependencias frente a tus políticas. Para obtener una visión completa del estado del proyecto, el endpoint whenlabs_summary proporciona un resumen unificado de todos los escáneres en una sola llamada.
Más allá de las comprobaciones simples, las herramientas de velocidad te permiten cronometrar las tareas de programación usando velocity_start_task y velocity_end_task. Todo este sistema se ejecuta localmente usando Node 20+ y se comunica vía stdio. Reemplaza las antiguas registraciones de velocity-mcp con una única instalación unificada.
Qué puedes hacer con él
- 1Detectar conflictos de puertosPide a la IA que compruebe si algún puerto local ya está en uso antes de intentar iniciar un nuevo servidor de desarrollo.
- 2Validar variables de entornoHaz que la IA verifique que tu archivo .env actual coincida con el esquema requerido para evitar errores en tiempo de ejecución.
- 3Identificar discrepancias en la documentaciónSolicita un escaneo para ver si la documentación de tu proyecto ha quedado desactualizada en comparación con el código fuente real.
- 4Auditar licencias de dependenciasUtiliza la IA para escanear las dependencias de tu proyecto y asegurar que todas las licencias cumplan con la política de tu organización.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar WhenLabs MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar WhenLabs MCP en Claude Code
$ claude mcp add when -- npx -y @whenlabs/whenInstalar WhenLabs MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Instalar WhenLabs MCP en VS Code
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Instalar WhenLabs MCP en VS Code CLI
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'Instalar WhenLabs MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Instalar WhenLabs MCP en Codex
$ codex mcp add when -- npx -y @whenlabs/whenInstalar WhenLabs MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
Instalar WhenLabs MCP en Gemini CLI
$ gemini mcp add -s user when npx -- -y @whenlabs/whenInstalar WhenLabs MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Herramientas de WhenLabs MCP 8
Detectado desde el READMEaware_syncberth_checkenvalid_validatestale_scanvow_scanvelocity_start_taskvelocity_end_taskwhenlabs_summary
| aware_sync | — | |
| berth_check | — | |
| envalid_validate | — | |
| stale_scan | — | |
| vow_scan | — | |
| velocity_start_task | — | |
| velocity_end_task | — | |
| whenlabs_summary | — |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHub@whenlabs/when
Six tools. One install.
A single installable toolkit that brings six WhenLabs developer tools into your Claude Code workflow. After install, the tools are exposed over a single MCP server and Claude calls them automatically when relevant.
Install
npx @whenlabs/when install
One-time setup. The installer:
- Registers a single MCP server (
whenlabs) in your Claude Code configuration - Injects a CLAUDE.md block so Claude knows when to use each tool
- Cleans up any legacy
velocity-mcpregistration (velocity is now bundled)
The six tools
| Tool | Purpose |
|---|---|
| aware | Auto-detect stack and generate AI context files (CLAUDE.md, .cursorrules, …) |
| berth | Detect port conflicts before starting dev servers |
| envalid | Validate .env files against a schema |
| stale | Detect documentation drift between docs and code |
| vow | Scan dependency licenses and validate against policy |
| velocity | Time coding tasks and learn from historical data |
MCP tools
Eight endpoints across the six tools:
| Endpoint | What it does |
|---|---|
aware_sync |
Detect stack and regenerate AI context files |
berth_check |
Scan project for port conflicts |
envalid_validate |
Validate .env files against schema |
stale_scan |
Detect documentation drift |
vow_scan |
Scan licenses and validate against policy |
velocity_start_task |
Start timing a coding task |
velocity_end_task |
End timing and record results |
whenlabs_summary |
Unified rollup across all five scanners in one call |
All eight are served by the single whenlabs MCP server (stdio, Node 20+). Fix/init/auxiliary commands remain available via each tool's CLI (npx @whenlabs/<tool> --help).
CLI
when init # Onboard a project — detect stack, bootstrap configs, run all checks
when doctor # Run all six tools and show a unified health report
when install # Register MCP server in Claude Code
when uninstall # Remove MCP server
For per-tool operations, use the tool directly:
npx @whenlabs/stale scan
npx @whenlabs/envalid validate
npx @whenlabs/berth check
npx @whenlabs/aware sync
npx @whenlabs/vow scan
Manual MCP configuration
If you're not using the install command, add this to your Claude Code MCP config:
{
"mcpServers": {
"whenlabs": {
"command": "npx",
"args": ["@whenlabs/when", "when-mcp"]
}
}
}
License
MIT — see LICENSE
Preguntas sobre WhenLabs MCP
¿Cómo agrego WhenLabs MCP a Claude Code?
Ejecuta claude mcp add when -- npx -y @whenlabs/when en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego WhenLabs MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona WhenLabs MCP?
Expone 8 herramientas, incluidas aware_sync, berth_check, envalid_validate, stale_scan, vow_scan.
¿Cómo instalo el toolkit de WhenLabs?
Puedes instalarlo usando el comando npx @whenlabs/when install.
¿Puedo configurar el MCP server manualmente?
Sí, puedes añadir manualmente el servidor de whenlabs a tu configuración de MCP en Claude Code usando npx @whenlabs/when when-mcp.
¿Qué hace el comando 'when doctor'?
Ejecuta las seis herramientas y proporciona un informe de salud unificado para tu proyecto.