Grasp 是一款代码架构可视化与静态分析工具,同时提供 MCP(Model Context Protocol)服务器。它可以将任意 GitHub 或 GitLab 仓库(云端或自托管)或本地代码库在数秒内转化为交互式架构地图。当前版本 v3.21.0 总计包含 150 个 MCP 工具、8 个资源、2 个提示词,支持 35 种语言、11 个 AI 提供商以及通过 OpenRouter 访问的 200 多个模型、10 种图形视图,并集成了多模态知识图谱。
用途方面,Grasp 主要面向需要理解复杂代码架构的开发者、技术负责人和团队。它通过依赖图、架构分层图、树状图(按行数显示文件大小)和团队仪表板等视图,帮助用户快速掌握代码库结构。
主要能力包括:
- 代码智能分析:基于死代码、循环依赖、耦合指标和安全问题给出 A–F 评分(0–100 分)。
- 安全扫描:检测硬编码密钥、SQL 注入风险、危险的 eval() 用法和生产环境调试语句。v3.20.0 扩展了五层安全扫描套件 grasp_vulnerabilities,覆盖依赖 CVE(OSV.dev)、容器/运行时 CVE(NIST NVD)、本地供应链完整性检查、Socket.dev 行为分析和计划性监控(grasp_vuln_watch)。
- 模式检测:识别单例、工厂、观察者/事件模式、React hooks 以及反模式(如上帝对象、高耦合)。
- 影响范围分析:选择文件后可见所有下游受影响文件,PR 影响分析可粘贴 PR URL 计算变更影响范围。
- 活动热图:按提交频率着色,支持 GitHub API 或本地 git log。
- 重复与相似度检测:Dup 颜色模式高亮精确或近似重复代码,grasp_similarity 工具返回排名后的重复集群。
- 代码归属:从 git 历史获取每个文件的主要贡献者及行百分比,可跳转 GitHub Blame。
- 技术债务量化:将架构问题换算为开发者小时(可配置估算值,如循环依赖 4 小时、上帝文件 16 小时、严重安全问题 8 小时)。
- 共享嵌入:生成 <iframe>、README 徽章、React 片段和直接链接。
- 多模态知识图谱(v3.21.0,仅 MCP 服务器):grasp_ingest 解析 PDF、DOCX、XLSX、HTML、图片(OCR)、音视频(通过 @xenova/transformers + ffmpeg 的本地 Whisper)、YouTube 和 URL,实体与关系标记为 EXTRACTED 或 INFERRED,存入 SQLite kg.db,支持 BM25 + 向量混合检索;grasp_kg_ask 等工具可进行带引用的自然语言问答。本地优先多 LLM 层会自动检测 Ollama,在没有云密钥时回退至零凭据确定性引擎。
- 原生 AST 语言新增 Bash、Elixir 和 Julia,tree-sitter 支持的函数提取、调用计数和复杂度评分达到 19 种语言。
- 可选 MCP-over-HTTP 桥接:设置 GRASP_HTTP_MCP=1 可通过 Streamable HTTP(Bearer Token 认证)共享实例,端口 7333。
- Grasp Brain 持久化架构智能:结合 SQLite Brain(~/.grasp/brain.db,含 FTS5 全文索引和 384D 向量嵌入存储)与 Kuzu 图数据库(~/.grasp/graph/,支持 Cypher 查询),索引一次即可即时查询。
- CLI 子命令与编辑器钩子:grasp setup 检测 .claude/、.cursor/、.windsurf/ 并安装钩子,自动为 AI 编码助手提供代码库上下文,同时写入 CLAUDE.md 和 AGENTS.md。
使用方式:
- 浏览器应用:零配置,无需构建步骤或 npm install,由两个 HTML 文件构成。
- IDE 扩展:支持 Claude Code、Cursor 等 MCP 兼容代理。
- 浏览器扩展:在 GitHub 和 GitLab 页面显示浮动 Grasp 按钮,支持自托管 GitLab、GitHub Enterprise 和自定义主机。
- MCP 服务器:暴露全部分析引擎给 AI 助手。
- 团队仪表板:跨仓库跟踪健康状况,支持公共或私有仓库(需 Token)。
- 组织级仪表板:一条命令分析整个 GitHub 组织(最多 500 个仓库,5 并发),输出内嵌 Chart.js 的 HTML。
- PR 影响 GitHub Action:为每个 PR 自动发布结构化评论,包含风险徽章、变更文件影响范围、建议审查者、测试覆盖缺口。
适用场景:代码审查、架构理解、技术债务管理、安全审计、团队协作、AI 辅助编码上下文提供。
限制:多模态知识图谱仅运行于 Node MCP 服务器,不在浏览器应用中;部分解析器为可选延迟加载依赖;函数级画布节点上限 300;Socket.dev 每次扫描最多 50 个包;组织级仪表板最多 500 个仓库。所有分析在客户端完成,零数据收集。
关于具体价格、收费模式、平台兼容细节和效果数据,资料中暂未提供。