← 返回目录

ContextWeaver

社区

为 AI Agent 精心编织的代码库上下文引擎

GitHub 源仓库 ↗

★ 294 Stars 分类 · 开发工具热门源版本 bb0889832456

53FMRS · D

可靠性

10/20

安全与权限

8/20

维护活跃度

12/20

文档质量

13/20

安装易用性

10/20

整体评价良好。混合搜索和上下文扩展策略能有效提升代码检索质量，但依赖于外部 API，对隐私敏感环境可能有顾虑。配置简单，适合 AI 辅助开发场景。

查看 FMRS 评分方法 →

ContextWeaver 是一个基于 MCP 协议的语义代码检索引擎，采用混合搜索（向量+词法）、AST 语义分片、三阶段上下文扩展和 Token 感知打包，为 LLM 提供精准、相关的代码上下文。支持 TypeScript、JavaScript、Python、Go、Java、Rust 等语言。

工具能力

codebase-retrieval

根据语义意图和技术术语，检索代码库中最相关的代码片段，并附带上下文信息。

安装接入

全局安装：npm install -g @hsingjui/contextweaver 或 pnpm add -g @hsingjui/contextweaver。
初始化配置：运行 contextweaver init 创建 ~/.contextweaver/.env，并配置 Embedding 和 Reranker 的 API Key 及模型。
索引代码库：在项目根目录运行 contextweaver index。
启动 MCP 服务器：运行 contextweaver mcp。

claude_desktop_config.json

{
  "mcpServers": {
    "contextweaver": {
      "command": "contextweaver",
      "args": [
        "mcp"
      ]
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

需要语义代码检索的 AI 辅助编程工具。
希望减少手动搜索代码的开发者。
需要跨文件理解代码依赖的 Agent 应用。

不适合谁

需要实时代码编辑或修改的 IDE 插件。
不支持外部 Embedding API 的离线环境。
需要管理超大型代码库（超过百万级文件）的搜索场景。

所需权限

需要访问代码库文件系统（读取）。
需要调用外部 Embedding 和 Reranker API（网络请求）。
需要写入配置目录 ~/.contextweaver 用于存储索引和日志。

风险与副作用

API Key 泄露风险：配置文件中存储的密钥需妥善保管。
索引构建可能消耗较多内存和 CPU，尤其在大型代码库上。
检索结果可能包含敏感代码，需要注意输出内容的权限控制。

常见排障

检查 ~/.contextweaver/.env 是否正确配置了 API Key 和模型名称。
确保代码库路径正确，且具有读取权限。
查看日志文件 ~/.contextweaver/logs/app.YYYY-MM-DD.log，通过 LOG_LEVEL=debug 查看详细错误。
如果索引未更新，尝试运行 contextweaver index --force 强制重建索引。

使用场景

AI 代码助手需要快速理解大型代码库的结构和特定功能实现。

开发者希望通过自然语言查询代码库，如“用户认证流程是如何实现的？”。

在 IDE 或聊天工具中集成 MCP，为 Agent 提供代码库检索能力。

支持客户端

Claude Desktop完整支持