Предоставляет инструментарий для разработчиков, который автоматизирует определение стека, проверку окружения, поиск конфликтов портов и выявление расхождений в документации.
Также известен как WhenLabs-org/when, @whenlabs/when
- Звёзды
- 4
- Инструменты
- 8
- Загрузки, 30 дней
- —
- Последняя версия
- 0.12.3
- Последний коммит
- 9 нояб. 2026 г.
- Лицензия
- MIT
Что такое WhenLabs MCP?
WhenLabs — это MCP server. Предоставляет инструментарий для разработчиков, который автоматизирует определение стека, проверку окружения, поиск конфликтов портов и выявление расхождений в документации. Он предоставляет 8 инструментов, например aware_sync, berth_check, envalid_validate.
Сводка сгенерирована из README проекта
О WhenLabs MCP server
Этот инструментарий позволяет разработчикам автоматизировать проверку состояния проекта и валидацию окружения непосредственно в Claude Code. Установив сервер через npx, вы интегрируете в свой рабочий процесс шесть специализированных инструментов, которые Claude может вызывать автоматически. Процесс настройки регистрирует сервер whenlabs и внедряет блок CLAUDE.md, чтобы ИИ понимал, как использовать доступные эндпоинты.
Пользователи могут управлять своей средой разработки с помощью специальных эндпоинтов, таких как berth_check для поиска конфликтов портов или envalid_validate для проверки .env файлов на соответствие схеме. Инструментарий также включает stale_scan для поиска расхождений в документации и vow_scan для проверки лицензий зависимостей на соответствие вашим политикам. Для получения полной картины состояния проекта эндпоинт whenlabs_summary предоставляет сводную информацию по всем сканерам за один вызов.
Помимо простых проверок, инструменты velocity позволяют замерять время выполнения задач по написанию кода с помощью velocity_start_task и velocity_end_task. Вся система работает локально на Node 20+ и взаимодействует через stdio. Она заменяет устаревшие регистрации velocity-mcp единой унифицированной установкой.
Что вы можете с ним делать
- 1Обнаружение конфликтов портовПопросите ИИ проверить, не заняты ли локальные порты, прежде чем пытаться запустить новый сервер разработки.
- 2Валидация переменных окруженияПопросите ИИ проверить, соответствует ли ваш текущий .env файл требуемой схеме, чтобы предотвратить ошибки во время выполнения.
- 3Выявление расхождений в документацииЗапустите сканирование, чтобы узнать, не устарела ли документация вашего проекта по сравнению с фактическим исходным кодом.
- 4Аудит лицензий зависимостейИспользуйте ИИ для сканирования зависимостей вашего проекта, чтобы убедиться, что все лицензии соответствуют политике вашей организации.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить WhenLabs MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка WhenLabs MCP в Claude Code
$ claude mcp add when -- npx -y @whenlabs/whenУстановка WhenLabs MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Установка WhenLabs MCP в VS Code
.vscode/mcp.json
{
"servers": {
"when": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Установка WhenLabs MCP в VS Code CLI
$ code --add-mcp '{"name":"when","type":"stdio","command":"npx","args":["-y","@whenlabs/when"]}'Установка WhenLabs MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Установка WhenLabs MCP в Codex
$ codex mcp add when -- npx -y @whenlabs/whenУстановка WhenLabs MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.when] command = "npx" args = ["-y", "@whenlabs/when"]
Установка WhenLabs MCP в Gemini CLI
$ gemini mcp add -s user when npx -- -y @whenlabs/whenУстановка WhenLabs MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"when": {
"command": "npx",
"args": [
"-y",
"@whenlabs/when"
]
}
}
}Инструменты WhenLabs MCP 8
Определено из 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 | — |
Автоматические проверки
Запущено 13 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует 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 toolkit?
Вы можете установить его с помощью команды npx @whenlabs/when install.
Можно ли настроить MCP server вручную?
Да, вы можете вручную добавить сервер whenlabs в конфигурацию Claude Code MCP, используя npx @whenlabs/when when-mcp.
Что делает команда 'when doctor'?
Она запускает все шесть инструментов и предоставляет единый отчет о состоянии вашего проекта.