核心用法
index1 是一款面向AI编程助手的项目级知识库工具，通过MCP协议提供5个搜索工具。用户通过 pipx install index1 安装后，配置 .mcp.json 即可在Claude等AI客户端中调用。核心工作流为：先用 index1 index ./src 建立索引，AI通过 docs_search 进行混合检索（BM25全文+向量语义），docs_get 获取完整内容，还支持状态查询、重新索引和配置管理。
显著优点
- 混合搜索架构：BM25与向量搜索经RRF融合，兼顾关键词精准与语义理解
- 结构感知分块：针对Markdown、Python、Rust、JS等语言优化切片策略
- CJK深度优化：中日韩查询自动检测并动态调权，解决英文代码库的中文检索难题
- 优雅降级：无Ollama时纯BM25模式仍可运行（60-80ms延迟）
- Token效率：高频率关键词搜索可减少97%的上下文消耗（对比Grep 881行→5摘要）
潜在缺点/局限性
- 向量搜索依赖Ollama本地模型（nomic-embed-text 270MB/bge-m3 1.2GB），初次配置较重
- 中文支持需额外安装
index1[chinese]依赖包 - 作为较新的MCP生态工具，社区案例和最佳实践积累有限
- 索引需手动维护，大型项目首次建立可能耗时
适合人群
- 使用Claude/Cursor等AI编辑器的中大型项目开发者
- 需要跨语言检索的国际化团队（尤其CJK用户）
- 追求上下文Token成本优化的AI辅助编程用户
- 对RAG架构有基础理解的技术团队
常规风险
- 本地Ollama模型运行需持续占用显存/内存
- MCP Server通过stdio通信，路径配置错误会导致工具无法识别
- 索引文件可能包含敏感代码信息，需注意本地存储安全
- 混合搜索结果质量依赖分块策略，复杂嵌套代码可能切分不当