Repolode
ory

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. 1

    安装 Ollama 并拉取默认嵌入模型

    ollama pull ordis/jina-embeddings-v2-base-code
  2. 2

    从插件市场安装 Claude Code 插件

    /plugin marketplace add ory/claude-plugins
  3. 3

    在 Claude Code 中安装 Lumen 插件

    /plugin install lumen@ory
  4. 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 数据每日更新。

相关项目