architecture_viewer
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DO_NOT_TRACK | No | Set to 1 to permanently disable telemetry (highest priority). | |
| ARCH_TELEMETRY | No | Set to 1 to enable CLI telemetry (default disabled). Records event name (CLI command name), duration (ms), exit code, CLI version, and OS type only. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| av_guardA | 日常结构验收(跨 Cursor / Claude / DeepSeek Harness 等):无基线时自动 ensure,有 git 对照 HEAD,返回 ≤3 行 verdict。宣称完成前优先调这个。HTML 详情可选。必须显式传当前工作区绝对路径 repo。 |
| av_session_startA | 改代码之前拍一张"改之前"的照片(记录当前结构)。MCP 长期进程还会开启自动监听(默认约 8 秒防抖);CLI 不会持续监听,改完需手动 report。日常优先 av_guard。必须显式传当前工作区绝对路径 repo;务必回显返回的 path.checking。完全离线。 |
| av_session_changesA | 轻量检查"有没有架构变更"——不生成文件、秒回。若 status=analyzing,看 remainingSec;不想等请直接调 av_session_report 或 av_guard(会取消防抖立即重算)。必须显式传当前工作区绝对路径 repo。 |
| av_session_reportA | 看本轮结构验收结论(对话内 verdict:灯色 + 风险计数 + 最严重 1 条)与完整报告。有 git 时默认对照 HEAD,不必先 av_session_start。日常可用 av_guard(会自动 ensure)。有进行中的防抖时会取消并立即重算。默认写出内置 HTML(Before/Delta/After)。HTML 为可选深挖。必须显式传当前工作区绝对路径 repo。 |
| av_statusB | 给使用者看的会话状态:基线在哪、watcher 是否在跑、监听哪个仓、报告是缓存还是过期、实时指纹有没有变。必须显式传当前工作区绝对路径 repo。 |
| av_check_layeringA | 检查当前仓库快照(不使用基线,包含历史存量,不能归因于本轮变更)。分层违规、其他结构问题、分析提示分别计数;现有依赖/体量/孤立实体另列 inventory,不算分层违规。不执行本轮变更专用规则。日常验收用 av_guard / av_session_report。返回实际运行包及分析源码摘要。完全离线。必须显式传当前工作区绝对路径 repo。 |
| av_explain_findingA | 解释某条 finding 的结构化边证据与修复建议。默认与 av_check_layering 使用同一仓库快照口径和 findings 索引(不含 inventory)。from=session 时只读本轮报告,找不到就报错,不会静默改扫全楼。必须显式传当前工作区绝对路径 repo。 |
| av_archify_exportA | 人工确认后,把本轮结构 diff 导出为 Archify IR 稀疏图(Before/After JSON + sidecar)。默认不导出、不自动出图。必须先核对证据再传 confirm=true。scope=changed(默认)只含变更文件;过密或纯新增时降级为 layers。validate=true 时若本机有 archify 会顺带校验;返回 validation.status=validated|validate_failed|not_validated|not_requested,未校验/失败不得当成已验证成品。必须显式传当前工作区绝对路径 repo。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Tools are mostly distinct, but av_guard, av_session_report, av_session_changes, and av_check_layering all deal with architecture verification and could be confused by an agent unfamiliar with the daily vs session vs snapshot distinction. Descriptions provide guidance, reducing but not eliminating overlap.
All tool names use the av_ prefix and snake_case, with predictable action-oriented suffixes. The convention is uniform across the set.
Eight tools is a well-scoped set for an architecture verification/viewer server, covering session lifecycle, checks, and export without redundancy.
The surface covers start, change detection, reporting, status, guard, finding explanation, layering check, and export. Minor gaps might include direct finding listing or configuration, but core workflows are present.