Menyediakan toolkit developer yang mengotomatiskan deteksi stack, validasi environment, pengecekan konflik port, dan deteksi dokumentasi yang tidak sinkron.
Juga dikenal sebagai WhenLabs-org/when, @whenlabs/when
- Stars
- 4
- Tools
- 8
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.12.3
- Commit terakhir
- 9 Nov 2026
- Lisensi
- MIT
Apa itu WhenLabs MCP?
WhenLabs adalah MCP server. Menyediakan toolkit developer yang mengotomatiskan deteksi stack, validasi environment, pengecekan konflik port, dan deteksi dokumentasi yang tidak sinkron. Server ini menyediakan 8 tool, seperti aware_sync, berth_check, envalid_validate.
Ringkasan dibuat dari README proyek
Tentang WhenLabs MCP server
Toolkit ini memungkinkan developer untuk mengotomatiskan pengecekan kesehatan proyek dan validasi environment di dalam Claude Code. Dengan menginstal server via npx, Anda mengintegrasikan enam tools khusus ke dalam workflow Anda yang dapat dipanggil secara otomatis oleh Claude. Proses setup akan mendaftarkan server whenlabs dan menyuntikkan blok CLAUDE.md agar AI memahami cara menggunakan endpoint yang tersedia.
User dapat mengelola development environment mereka melalui endpoint spesifik seperti berth_check untuk konflik port atau envalid_validate untuk memverifikasi file .env terhadap sebuah schema. Toolkit ini juga menyertakan stale_scan untuk menemukan dokumentasi yang tidak sinkron dan vow_scan untuk memeriksa lisensi dependency terhadap kebijakan Anda. Untuk melihat gambaran lengkap status proyek, endpoint whenlabs_summary menyediakan ringkasan terpadu dari semua scanner dalam satu kali pemanggilan.
Selain pengecekan sederhana, tools velocity memungkinkan Anda untuk mencatat waktu tugas coding menggunakan velocity_start_task dan velocity_end_task. Seluruh sistem ini berjalan secara lokal menggunakan Node 20+ dan berkomunikasi via stdio. Toolkit ini menggantikan registrasi legacy velocity-mcp dengan satu instalasi yang terpadu.
Apa yang bisa Anda lakukan dengannya
- 1Mendeteksi konflik portMinta AI untuk mengecek apakah ada port lokal yang sudah digunakan sebelum Anda mencoba menjalankan development server baru.
- 2Validasi environment variablesGunakan AI untuk memverifikasi bahwa file .env Anda saat ini sudah sesuai dengan schema yang dibutuhkan guna mencegah runtime error.
- 3Mengidentifikasi dokumentasi yang tidak sinkronMinta pemindaian untuk melihat apakah dokumentasi proyek Anda sudah kedaluwarsa dibandingkan dengan source code yang sebenarnya.
- 4Audit lisensi dependencyGunakan AI untuk memindai dependency proyek Anda guna memastikan semua lisensi telah mematuhi kebijakan organisasi Anda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal WhenLabs MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal WhenLabs MCP di Claude Code
$ claude mcp add when -- npx -y @whenlabs/whenInstal WhenLabs MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Instal WhenLabs MCP di VS Code
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Instal WhenLabs MCP di VS Code CLI
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'Instal WhenLabs MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Instal WhenLabs MCP di Codex
$ codex mcp add when -- npx -y @whenlabs/whenInstal WhenLabs MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
Instal WhenLabs MCP di Gemini CLI
$ gemini mcp add -s user when npx -- -y @whenlabs/whenInstal WhenLabs MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Tool WhenLabs MCP 8
Terdeteksi dari 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 | — |
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di 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
Pertanyaan tentang WhenLabs MCP
Bagaimana cara menambahkan WhenLabs MCP ke Claude Code?
Jalankan claude mcp add when -- npx -y @whenlabs/when di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan WhenLabs MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan WhenLabs MCP?
Server ini menyediakan 8 tool, termasuk aware_sync, berth_check, envalid_validate, stale_scan, vow_scan.
Bagaimana cara menginstal WhenLabs toolkit?
Anda dapat menginstalnya menggunakan command npx @whenlabs/when install.
Bisakah saya mengonfigurasi MCP server secara manual?
Ya, Anda bisa menambahkan server whenlabs secara manual ke config MCP Claude Code Anda menggunakan npx @whenlabs/when when-mcp.
Apa fungsi dari command 'when doctor'?
Command ini menjalankan keenam tools dan memberikan laporan kesehatan terpadu untuk proyek Anda.