Stack tespiti, ortam doğrulama, port çakışması kontrolü ve dokümantasyon sapması tespitini otomatikleştiren bir geliştirici araç seti sunar.
Ayrıca bilinen adı WhenLabs-org/when, @whenlabs/when
- Yıldızlar
- 4
- Araçlar
- 8
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.12.3
- Son commit
- 9 Kas 2026
- Lisans
- MIT
WhenLabs MCP nedir?
WhenLabs bir MCP sunucusudur. Stack tespiti, ortam doğrulama, port çakışması kontrolü ve dokümantasyon sapması tespitini otomatikleştiren bir geliştirici araç seti sunar. 8 araç sunar; örneğin aware_sync, berth_check, envalid_validate.
Özet, projenin README dosyasından oluşturuldu
WhenLabs MCP sunucusu hakkında
Bu araç seti, geliştiricilerin Claude Code içerisinde proje sağlık kontrollerini ve ortam doğrulama süreçlerini otomatikleştirmesini sağlar. Sunucuyu npx aracılığıyla kurarak, Claude'un otomatik olarak çağırabileceği altı özel aracı iş akışınıza entegre edersiniz. Kurulum süreci, whenlabs server'ı kaydeder ve yapay zekanın mevcut uç noktaları nasıl kullanacağını anlaması için bir CLAUDE.md bloğu ekler.
Kullanıcılar, port çakışmaları için berth_check veya .env dosyalarını bir şemaya göre doğrulamak için envalid_validate gibi özel uç noktalar aracılığıyla geliştirme ortamlarını yönetebilirler. Araç seti ayrıca, dokümantasyon sapmalarını bulmak için stale_scan ve bağımlılık lisanslarını politikalarınıza göre kontrol etmek için vow_scan özelliklerini de içerir. Proje durumuna dair tam bir genel bakış için whenlabs_summary uç noktası, tüm tarayıcıların birleşik bir özetini tek bir çağrıda sunar.
Basit kontrollerin ötesinde, velocity araçları velocity_start_task ve velocity_end_task kullanarak kodlama görevlerini zamanlamanıza olanak tanır. Tüm bu sistem Node 20+ kullanarak yerel olarak çalışır ve stdio üzerinden iletişim kurar. Eski velocity-mcp kayıtlarının yerini tek ve birleşik bir kurulum alır.
Neler yapabilirsiniz
- 1Port çakışmalarını tespit etmeYeni bir geliştirme sunucusu başlatmaya çalışmadan önce, herhangi bir yerel portun kullanımda olup olmadığını kontrol etmesi için yapay zekadan talepte bulunun.
- 2Ortam değişkenlerini doğrulamaÇalışma zamanı hatalarını önlemek için mevcut .env dosyanızın gerekli şema ile eşleştiğini yapay zekaya doğrulatın.
- 3Dokümantasyon sapmasını belirlemeProje dokümantasyonunuzun gerçek kaynak koduna kıyasla güncelliğini yitirip yitirmediğini görmek için bir tarama isteyin.
- 4Bağımlılık lisanslarını denetlemeTüm lisansların kuruluşunuzun politikasına uygun olduğundan emin olmak için proje bağımlılıklarınızı taramak üzere yapay zekayı kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
WhenLabs MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWhenLabs MCP'yi Claude Code içine yükleyin
$ claude mcp add when -- npx -y @whenlabs/whenWhenLabs MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'WhenLabs MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP'yi Codex içine yükleyin
$ codex mcp add when -- npx -y @whenlabs/whenWhenLabs MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
WhenLabs MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user when npx -- -y @whenlabs/whenWhenLabs MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP araçları 8
README dosyasından algılandıaware_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 | — |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@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 soruları
WhenLabs MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add when -- npx -y @whenlabs/when komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
WhenLabs MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
WhenLabs MCP hangi araçları sunar?
8 araç sunar; bunlar arasında aware_sync, berth_check, envalid_validate, stale_scan, vow_scan yer alır.
WhenLabs araç setini nasıl kurabilirim?
npx @whenlabs/when install komutunu kullanarak kurulum yapabilirsiniz.
MCP server yapılandırmasını manuel olarak yapabilir miyim?
Evet, npx @whenlabs/when when-mcp komutunu kullanarak whenlabs server'ı Claude Code MCP konfigürasyonunuza manuel olarak ekleyebilirsiniz.
'when doctor' komutu ne işe yarar?
Altı aracın tamamını çalıştırır ve projeniz için birleşik bir sağlık raporu sunar.