基于 AST 的语义代码搜索 CLI 与 MCP 服务,为编码代理按语义查找代码。
ory/lumen
本地语义代码搜索 MCP 服务,让 Claude Code、Codex 等 AI 编程助手按含义检索代码,无需上传数据。
- Star
- 316
- Fork
- 37
- 未关闭 Issue
- 29
- 最近提交
- 27天前
这是什么?
Lumen 是面向 AI 编程助手的本地语义代码搜索引擎。它以 MCP 服务的形式为项目建立向量索引,智能体可调用 semantic_search 按含义查找相关函数、类型和模块,而不必通读整个文件。向量由本地 Ollama 或 LM Studio 生成,存储在 SQLite(sqlite-vec)中,代码不会离开本机,也不需要云服务或外部数据库。
索引时,Go 文件使用原生 AST 切分,其他语言使用 tree-sitter 语法解析。基于文件哈希的 Merkle 树确保后续只重新嵌入变更的文件。同一仓库的 Git worktree 可以共享索引数据,索引存放在 ~/.local/share/lumen 下,不会写入项目目录。
项目为 Claude Code、Cursor、Codex 和 OpenCode 提供插件。仓库中的基准测试在多种语言的 bug 修复任务上显示成本和 token 用量有所下降,补丁质量保持不变。
核心功能
- 01通过 MCP 工具按语义搜索函数、类型和模块
- 02基于 Merkle 树差异的增量索引,仅重新嵌入变更文件
- 03通过 Ollama 或 LM Studio 在本地生成向量,不依赖云端
- 04索引存储于 SQLite(sqlite-vec),位于项目目录之外
- 05使用 Go AST 与 tree-sitter 解析器,支持 12 类语言
- 06Git worktree 共享索引数据,新 worktree 可复用同仓库已有索引
适用场景
- 让 Claude Code 或 Codex 在大型 monorepo 中快速定位相关代码,而非通读文件
- 在本地完成嵌入计算,适合对代码隐私有严格要求的团队
- 减少 AI 智能体探索陌生代码库时的 token 消耗
- 在同一项目的多个 Git worktree 之间共享索引,加快切换
快速上手
- 1
安装 Ollama 并拉取默认嵌入模型
ollama pull ordis/jina-embeddings-v2-base-code - 2
从插件市场安装 Claude Code 插件
/plugin marketplace add ory/claude-plugins - 3
在 Claude Code 中安装 Lumen 插件
/plugin install lumen@ory - 4
启动新的 Claude 会话并运行健康检查
/lumen:doctor
使用前须知
- 需要在运行智能体的同时运行本地 Ollama 或 LM Studio 嵌入服务。
- 元数据中的许可证显示为 NOASSERTION,使用前请查看 LICENSE 文件。
收录于专题
标签
常见问题
- lumen 是什么?
- 本地语义代码搜索 MCP 服务,让 Claude Code、Codex 等 AI 编程助手按含义检索代码,无需上传数据。 Lumen 是面向 AI 编程助手的本地语义代码搜索引擎。它以 MCP 服务的形式为项目建立向量索引,智能体可调用 semantic_search 按含义查找相关函数、类型和模块,而不必通读整个文件。向量由本地 Ollama 或 LM Studio 生成,存储在 SQLite(sqlite-vec)中,代码不会离开本机,也不需要云服务或外部数据库。
- lumen 可以免费使用吗?用的什么许可证?
- lumen 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- lumen 还在维护吗?
- 活跃维护中。lumen 最近一次提交是在 2026年10月11日。
- lumen 适合用来做什么?
- 让 Claude Code 或 Codex 在大型 monorepo 中快速定位相关代码,而非通读文件 在本地完成嵌入计算,适合对代码隐私有严格要求的团队 减少 AI 智能体探索陌生代码库时的 token 消耗 在同一项目的多个 Git worktree 之间共享索引,加快切换
- lumen 怎么安装和运行?
- 安装 Ollama 并拉取默认嵌入模型: ollama pull ordis/jina-embeddings-v2-base-code 从插件市场安装 Claude Code 插件: /plugin marketplace add ory/claude-plugins 在 Claude Code 中安装 Lumen 插件: /plugin install lumen@ory 启动新的 Claude 会话并运行健康检查: /lumen:doctor
- 在哪里获取 lumen?
- 源代码和安装说明在 GitHub 上:https://github.com/ory/lumen
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
本地运行的语义代码搜索命令行工具,支持调用图追踪,并可作为 MCP 服务供 AI 编程助手调用。
在各自独立的 Docker 容器中运行多个 Claude Code 会话,并通过网页面板统一管理。
本地优先的语义代码搜索工具,结合向量嵌入与 ripgrep,可用自然语言查询代码库。
将 Zotero 文献库接入 Claude、ChatGPT 等 AI 助手的 MCP 服务与命令行工具,用于检索、阅读和标注论文。
一个本地运行的 Rust 工具,通过语义搜索让 Claude Code 记住过去的对话,以 MCP 服务器形式提供。