Bietet ein Developer-Toolkit, das Stack-Detection, Environment-Validierung, Port-Konflikt-Checks und die Erkennung von Documentation Drift automatisiert.
Auch bekannt als WhenLabs-org/when, @whenlabs/when
- Stars
- 4
- Tools
- 8
- Downloads, 30 Tage
- —
- Neueste Version
- 0.12.3
- Letzter Commit
- 9. Nov. 2026
- Lizenz
- MIT
Was ist WhenLabs MCP?
WhenLabs ist ein MCP server. Bietet ein Developer-Toolkit, das Stack-Detection, Environment-Validierung, Port-Konflikt-Checks und die Erkennung von Documentation Drift automatisiert. Er stellt 8 Tools bereit, etwa aware_sync, berth_check, envalid_validate.
Zusammenfassung generiert aus dem README des Projekts
Über WhenLabs MCP server
Dieses Toolkit ermöglicht es Entwicklern, Project Health Checks und die Validierung der Umgebung direkt in Claude Code zu automatisieren. Durch die Installation des Servers via npx integrierst du sechs spezialisierte Tools in deinen Workflow, die Claude automatisch aufrufen kann. Der Setup-Prozess registriert den whenlabs server und injiziert einen CLAUDE.md Block, damit die KI versteht, wie sie die verfügbaren Endpoints nutzen kann.
Nutzer können ihre Entwicklungsumgebung über spezifische Endpoints verwalten, wie etwa berth_check für Port-Konflikte oder envalid_validate, um .env Dateien gegen ein Schema zu prüfen. Das Toolkit enthält außerdem stale_scan, um Documentation Drift zu finden, und vow_scan, um Dependency-Lizenzen gegen deine Policies zu prüfen. Für einen vollständigen Überblick über den Projektstatus liefert der whenlabs_summary Endpoint eine zusammengefasste Auswertung aller Scanner in einem einzigen Call.
Über einfache Checks hinaus ermöglichen die Velocity-Tools das Zeitmessen von Coding-Tasks mittels velocity_start_task und velocity_end_task. Das gesamte System läuft lokal mit Node 20+ und kommuniziert via stdio. Es ersetzt veraltete velocity-mcp Registrierungen durch eine einzige, einheitliche Installation.
Was du damit machen kannst
- 1Erkennung von Port-KonfliktenBitte die KI, zu prüfen, ob lokale Ports bereits belegt sind, bevor du versuchst, einen neuen Development Server zu starten.
- 2Validierung von UmgebungsvariablenLass die KI verifizieren, dass deine aktuelle .env Datei dem erforderlichen Schema entspricht, um Runtime-Errors zu vermeiden.
- 3Identifizierung von Documentation DriftFordere einen Scan an, um zu sehen, ob deine Projektdokumentation im Vergleich zum tatsächlichen Source Code veraltet ist.
- 4Audit von Dependency-LizenzenNutze die KI, um deine Projekt-Dependencies zu scannen und sicherzustellen, dass alle Lizenzen mit der Policy deiner Organisation übereinstimmen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du WhenLabs MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenWhenLabs MCP in Claude Code installieren
$ claude mcp add when -- npx -y @whenlabs/whenWhenLabs MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'WhenLabs MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP in Codex installieren
$ codex mcp add when -- npx -y @whenlabs/whenWhenLabs MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
WhenLabs MCP in Gemini CLI installieren
$ gemini mcp add -s user when npx -- -y @whenlabs/whenWhenLabs MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP tools 8
Erkannt aus dem 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 | — |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehen@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
WhenLabs MCP Fragen
Wie füge ich WhenLabs MCP zu Claude Code hinzu?
Führe claude mcp add when -- npx -y @whenlabs/when in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich WhenLabs MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet WhenLabs MCP?
Er stellt 8 Tools bereit, darunter aware_sync, berth_check, envalid_validate, stale_scan, vow_scan.
Wie installiere ich das WhenLabs Toolkit?
Du kannst es mit dem Befehl npx @whenlabs/when install installieren.
Kann ich den MCP server manuell konfigurieren?
Ja, du kannst den whenlabs server manuativ zu deiner Claude Code MCP Config hinzufügen, indem du npx @whenlabs/when when-mcp nutzt.
Was macht der Befehl 'when doctor'?
Er führt alle sechs Tools aus und erstellt einen einheitlichen Health-Report für dein Projekt.