스택 감지, 환경 검증, 포트 충돌 확인 및 문서 드리프트 감지를 자동화하는 개발자 툴킷을 제공합니다.
다른 이름 WhenLabs-org/when, @whenlabs/when
- 스타
- 4
- Tools
- 8
- 다운로드, 30일
- —
- 최신 버전
- 0.12.3
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
WhenLabs MCP란?
WhenLabs은(는) MCP server입니다. 스택 감지, 환경 검증, 포트 충돌 확인 및 문서 드리프트 감지를 자동화하는 개발자 툴킷을 제공합니다. 8개 도구를 제공합니다. 예: aware_sync, berth_check, envalid_validate.
프로젝트 README에서 생성된 요약
WhenLabs MCP server 정보
이 툴킷은 Claude Code 내에서 프로젝트 상태 확인과 환경 검증을 자동화할 수 있도록 개발자를 지원합니다. npx를 통해 server를 설치하면 Claude가 자동으로 호출할 수 있는 6가지 특화 도구를 워크플로우에 통합할 수 있습니다. 설정 과정에서 whenlabs server가 등록되고 CLAUDE.md 블록이 삽입되어, AI가 사용 가능한 엔드포인트를 어떻게 활용할지 이해하게 됩니다.
사용자는 포트 충돌을 확인하는 berth_check나 스키마를 기준으로 .env 파일을 검증하는 envalid_validate와 같은 특정 엔드포인트를 통해 개발 환경을 관리할 수 있습니다. 또한 문서 드리프트를 찾는 stale_scan과 의존성 라이선스가 정책에 부합하는지 확인하는 vow_scan 기능도 포함되어 있습니다. 프로젝트 상태를 전체적으로 파악하려면 whenlabs_summary 엔드포인트를 통해 단 한 번의 호출로 모든 스캐너의 통합 요약 정보를 받을 수 있습니다.
단순한 확인 기능을 넘어, velocity 도구를 사용하면 velocity_start_task 및 velocity_end_task를 통해 코딩 작업 시간을 측정할 수 있습니다. 이 전체 시스템은 Node 20+ 환경에서 로컬로 실행되며 stdio를 통해 통신합니다. 기존의 velocity-mcp 등록 방식을 단일화된 통합 설치 방식으로 대체합니다.
활용 사례
- 1포트 충돌 감지새로운 개발 서버를 시작하기 전에 로컬 포트가 이미 사용 중인지 AI에게 확인하도록 요청합니다.
- 2환경 변수 검증런타임 오류를 방지하기 위해 현재 .env 파일이 요구되는 스키마와 일치하는지 AI가 검증하도록 합니다.
- 3문서 드리프트 식별프로젝트 문서가 실제 소스 코드와 비교하여 최신 상태를 유지하고 있는지 확인하기 위해 스캔을 요청합니다.
- 4의존성 라이선스 감사AI를 사용하여 프로젝트 의존성을 스캔하고 모든 라이선스가 조직의 정책을 준수하는지 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
WhenLabs MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 WhenLabs MCP 설치
$ claude mcp add when -- npx -y @whenlabs/whenCursor에 WhenLabs MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}VS Code에 WhenLabs MCP 설치
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}VS Code CLI에 WhenLabs MCP 설치
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'Claude Desktop에 WhenLabs MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Codex에 WhenLabs MCP 설치
$ codex mcp add when -- npx -y @whenlabs/whenCodex config.toml에 WhenLabs MCP 설치
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
Gemini CLI에 WhenLabs MCP 설치
$ gemini mcp add -s user when npx -- -y @whenlabs/whenGemini settings.json에 WhenLabs MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}WhenLabs MCP 도구 8
README에서 감지됨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 | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
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
WhenLabs MCP 질문
WhenLabs MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add when -- npx -y @whenlabs/when를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
WhenLabs MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
WhenLabs MCP는 어떤 도구를 제공하나요?
8개 도구를 제공합니다. 예: aware_sync, berth_check, envalid_validate, stale_scan, vow_scan.
WhenLabs 툴킷을 어떻게 설치하나요?
npx @whenlabs/when install 명령어를 사용하여 설치할 수 있습니다.
MCP server를 수동으로 설정할 수 있나요?
네, npx @whenlabs/when when-mcp를 사용하여 Claude Code MCP 설정에 whenlabs server를 수동으로 추가할 수 있습니다.
'when doctor' 명령어는 어떤 역할을 하나요?
6가지 도구를 모두 실행하여 프로젝트에 대한 통합 상태 보고서를 제공합니다.