ContextAtlas 是一个 MCP(Model Context Protocol)服务器,定位是为 AI 编程助手提供融合代码结构与架构意图的上下文服务。根据官方描述,它把 LSP 级别的结构信息与来自架构决策记录(ADR)、git 历史和测试的架构意图结合起来,从而在架构相关查询中显著减少 token 用量,同时保持答案一致。
主要能力
- get_symbol_context:在单次 MCP 调用中获取一个符号的完整上下文,包括其类型、调用方、ADR 中的理由说明以及相关测试。
- find_by_intent:基于代码的用途而非仅为名称进行搜索,底层使用 FTS5 BM25 对提交记录、ADR 和测试进行检索。
- impact_of_change:在修改某个符号之前,遍历其在结构和历史层面的影响范围(blast radius),帮助评估改动可能波及的部分。
使用方式 官方资料将其描述为一个 MCP 服务器,面向 Claude Code 提供上下文捆绑(context bundles)。这意味着它需要接入支持 MCP 的客户端,供 AI 在查询代码架构、符号上下文或影响分析时调用。至于具体的安装命令、配置步骤、支持的客户端版本或环境要求,资料中暂未提供。
适用场景
- 需要让 AI 在大型代码库中理解架构决策与设计理由,而不仅是语法结构。
- 希望 AI 基于项目自身的设计主旨和范围(而非通用最佳实践)提出或执行设计选择。
- 在编辑符号前评估结构性和历史性的影响范围。
- 减少架构类查询的 token 消耗,官方称在 hono 和 httpx 上的锁定 24 提示基准测试中测得减少 45%–72%。
限制 官方资料未说明支持的编程语言、仓库规模、集成方式、定价模式或平台兼容性。token 减少数据基于特定基准测试(hono 与 httpx 上的 24 个提示),实际效果可能因项目而异。具体安装与配置细节需查阅官方文档。