Fournit une boîte à outils pour développeurs qui automatise la détection de la stack, la validation de l'environnement, la vérification des conflits de ports et la détection de l'écart de documentation.
Aussi connu sous WhenLabs-org/when, @whenlabs/when
- Étoiles
- 4
- Outils
- 8
- Téléchargements, 30 jours
- —
- Dernière version
- 0.12.3
- Dernier commit
- 9 nov. 2026
- Licence
- MIT
Qu'est-ce que WhenLabs MCP ?
WhenLabs est un serveur MCP. Fournit une boîte à outils pour développeurs qui automatise la détection de la stack, la validation de l'environnement, la vérification des conflits de ports et la détection de l'écart de documentation. Il expose 8 outils, comme aware_sync, berth_check, envalid_validate.
Résumé généré à partir du README du projet
À propos du MCP server WhenLabs
Ce toolkit permet aux développeurs d'automatiser les vérifications de santé du projet et la validation de l'environnement au sein de Claude Code. En installant le serveur via npx, vous intégrez six outils spécialisés à votre workflow que Claude peut appeler automatiquement. Le processus d'installation enregistre le serveur whenlabs et injecte un bloc CLAUDE.md afin que l'IA comprenne comment utiliser les endpoints disponibles.
Les utilisateurs peuvent gérer leur environnement de développement via des endpoints spécifiques comme berth_check pour les conflits de ports ou envalid_validate pour vérifier les fichiers .env par rapport à un schéma. Le toolkit inclut également stale_scan pour détecter l'écart de documentation et vow_scan pour vérifier la conformité des licences de dépendances avec vos politiques. Pour une vue d'ensemble complète de l'état du projet, l'endpoint whenlabs_summary fournit un récapitulatif unifié de tous les scanners en un seul appel.
Au-delà des simples vérifications, les outils de vélocité vous permettent de chronométrer vos tâches de codage à l'aide de velocity_start_task et velocity_end_task. L'ensemble du système s'exécute localement avec Node 20+ et communique via stdio. Il remplace les anciennes inscriptions velocity-mcp par une installation unique et unifiée.
Ce que vous pouvez faire avec
- 1Détection de conflits de portsDemandez à l'IA de vérifier si des ports locaux sont déjà utilisés avant de tenter de démarrer un nouveau serveur de développement.
- 2Validation des variables d'environnementDemandez à l'IA de vérifier que votre fichier .env actuel correspond au schéma requis afin d'éviter des erreurs d'exécution.
- 3Identification de l'écart de documentationLancez un scan pour voir si la documentation de votre projet est devenue obsolète par rapport au code source réel.
- 4Audit des licences de dépendancesUtilisez l'IA pour scanner les dépendances de votre projet afin de vous assurer que toutes les licences sont conformes à la politique de votre organisation.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer WhenLabs MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller WhenLabs MCP dans Claude Code
$ claude mcp add when -- npx -y @whenlabs/whenInstaller WhenLabs MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Installer WhenLabs MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Installer WhenLabs MCP dans VS Code CLI
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'Installer WhenLabs MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Installer WhenLabs MCP dans Codex
$ codex mcp add when -- npx -y @whenlabs/whenInstaller WhenLabs MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
Installer WhenLabs MCP dans Gemini CLI
$ gemini mcp add -s user when npx -- -y @whenlabs/whenInstaller WhenLabs MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Outils MCP WhenLabs 8
Détectés depuis le 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 | — |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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
Questions sur WhenLabs MCP
Comment ajouter WhenLabs MCP à Claude Code ?
Exécutez claude mcp add when -- npx -y @whenlabs/when dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter WhenLabs MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils WhenLabs MCP fournit-il ?
Il expose 8 outils, dont aware_sync, berth_check, envalid_validate, stale_scan, vow_scan.
Comment installer le toolkit WhenLabs ?
Vous pouvez l'installer en utilisant la commande npx @whenlabs/when install.
Puis-je configurer le MCP server manuellement ?
Oui, vous pouvez ajouter manuellement le serveur whenlabs à votre configuration MCP de Claude Code en utilisant npx @whenlabs/when when-mcp.
Que fait la commande 'when doctor' ?
Elle exécute les six outils et fournit un rapport de santé unifié pour votre projet.