01
从零构建企业级私有代码知识库与 MCP 检索服务
CodeAtlas 如何在一台小型服务器上完成仓库同步、版本化索引、混合检索、权限隔离和 MCP 工具调用。
01 Versioned indexing
索引版本全部写入成功后原子切换，失败继续使用上一版本。
02 Hybrid retrieval
向量 Top 50 与 MySQL FULLTEXT Top 50 经 RRF 融合和重叠抑制。
03 Token-scoped MCP
仓库级范围、独立权限和只存哈希的 API Token。
PRODUCT ENGINEERING
工程与架构文档
02
混合代码检索：为什么向量搜索还需要 FULLTEXT 与 RRF
从标识符、自然语言和代码路径三类查询出发，拆解 CodeAtlas 的双路召回、RRF 融合与重叠抑制。
IMPLEMENTED SYSTEM
从 Git 提交到可引用的代码证据
- 解析
- Tree-sitter + bounded text windows
- 存储
- MySQL 8 · FULLTEXT · Chroma
- 接口
- FastAPI · MCP Streamable HTTP
- 边界
- RBAC · SSRF guard · path isolation