When

io.github.WhenLabs-org由 GitHub 账号 WhenLabs-org 发布v0.12.3更新于 Oct 24, 2026

The WhenLabs developer toolkit — 6 tools, 7 MCP endpoints, one install.

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

一个本地 MCP 服务器，打包六个 WhenLabs 开发工具，让助手检查端口冲突、环境变量架构、文档漂移、许可证策略和任务计时。

可以做什么
检测项目技术栈并重新生成 CLAUDE.md、.cursorrules 等 AI 上下文文件，并在启动开发服务器前扫描端口冲突。按架构校验 .env 文件，并检测文档与代码之间的漂移。扫描依赖许可证并按策略校验。开始和结束编码任务计时并记录结果。一次调用汇总五个扫描器的统一报告。
适用场景
适合在 Claude Code 中工作的开发者，希望不离开编辑器就能让助手执行项目健康检查：技术栈上下文文件、端口冲突、环境变量校验、文档漂移、许可证策略和任务计时。
运行要求
通过 npm 包安装，以 stdio 在本地运行，需要 Node 20 或更高版本。install 命令会把服务器注册到 Claude Code 配置并注入 CLAUDE.md 内容；也提供手动配置方式。未声明账号、API 密钥或环境变量。
安装前请注意
安装程序会修改 Claude Code 配置、添加 CLAUDE.md 内容并移除旧的 velocity-mcp 注册。部分工具会写入文件（如重新生成的 AI 上下文文件），扫描会读取项目文件，包括 .env 内容。提交前请检查改动。

安装

在 SourceWeft 中

  1. 打开 控制台中的 When，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@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.

[when doctor — six tools, one unified health report]

Install

bash
npx @whenlabs/when install

One-time setup. The installer:

  1. Registers a single MCP server (whenlabs) in your Claude Code configuration
  2. Injects a CLAUDE.md block so Claude knows when to use each tool
  3. Cleans up any legacy velocity-mcp registration (velocity is now bundled)

The six tools

ToolPurpose
awareAuto-detect stack and generate AI context files (CLAUDE.md, .cursorrules, …)
berthDetect port conflicts before starting dev servers
envalidValidate .env files against a schema
staleDetect documentation drift between docs and code
vowScan dependency licenses and validate against policy
velocityTime coding tasks and learn from historical data

MCP tools

Eight endpoints across the six tools:

EndpointWhat it does
aware_syncDetect stack and regenerate AI context files
berth_checkScan project for port conflicts
envalid_validateValidate .env files against schema
stale_scanDetect documentation drift
vow_scanScan licenses and validate against policy
velocity_start_taskStart timing a coding task
velocity_end_taskEnd timing and record results
whenlabs_summaryUnified 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

bash
when init       # Onboard a project — detect stack, bootstrap configs, run all checkswhen doctor     # Run all six tools and show a unified health reportwhen install    # Register MCP server in Claude Codewhen uninstall  # Remove MCP server

For per-tool operations, use the tool directly:

bash
npx @whenlabs/stale scannpx @whenlabs/envalid validatenpx @whenlabs/berth checknpx @whenlabs/aware syncnpx @whenlabs/vow scan

Manual MCP configuration

If you're not using the install command, add this to your Claude Code MCP config:

json
{  "mcpServers": {    "whenlabs": {      "command": "npx",      "args": ["@whenlabs/when", "when-mcp"]    }  }}

License

MIT — see LICENSE

Built by Siddharth at WhenLabs

来源：README.md，提交 c389d5f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.12.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分