Repolode
제출하기
ory

ory/lumen

Ollama 또는 LM Studio 임베딩을 사용해 Claude Code, Codex, Cursor, OpenCode에 코드베이스의 의미 기반 검색을 제공하는 로컬 시맨틱 코드 검색 MCP 서버입니다.

GitHub에서 보기웹사이트
스타
315
포크
37
열린 이슈
29
마지막 커밋
26일 전

어떤 프로젝트인가요?

Lumen은 AI 코딩 에이전트를 위한 로컬 시맨틱 코드 검색 엔진입니다. 프로젝트의 벡터 인덱스를 구축하는 MCP 서버로 실행되므로, 에이전트는 파일 전체를 읽는 대신 semantic_search를 호출해 관련 함수, 타입, 모듈을 찾을 수 있습니다. 임베딩은 로컬 Ollama 또는 LM Studio 서버에서 생성하고 sqlite-vec를 사용하는 SQLite에 저장하므로, 코드가 컴퓨터 밖으로 나가지 않으며 클라우드 서비스나 외부 데이터베이스도 필요하지 않습니다.

Go 파일은 Go의 기본 AST를 사용하고, 다른 언어는 tree-sitter 문법을 사용해 파일을 의미 단위 청크로 나눕니다. 파일 해시를 기반으로 한 Merkle 트리를 사용하므로 이후 실행에서는 변경된 파일만 다시 임베딩합니다. 같은 저장소의 Git worktree끼리는 인덱스 데이터를 공유할 수 있습니다. 인덱스는 저장소 내부가 아닌 ~/.local/share/lumen에 저장됩니다.

프로젝트에는 Claude Code, Cursor, Codex, OpenCode용 플러그인이 포함되어 있습니다. README에는 여러 언어의 버그 수정 작업을 대상으로 한 벤치마크 결과가 제시되어 있으며, 패치 품질을 유지하면서 비용과 토큰 사용량을 줄인 것으로 나타납니다.

핵심 기능

  • 01MCP 도구를 통해 함수, 타입, 모듈을 시맨틱 검색
  • 02Merkle 트리 비교를 사용해 변경된 파일만 다시 임베딩하는 증분 인덱싱
  • 03클라우드 의존성 없이 Ollama 또는 LM Studio로 로컬 임베딩 생성
  • 04SQLite와 sqlite-vec에 저장하며 프로젝트 디렉터리 외부에 보관
  • 05Go AST와 tree-sitter 파서를 사용해 12개 언어 계열 지원
  • 06Git worktree끼리 인덱스 데이터를 공유하고, 새 worktree는 인접 worktree의 데이터를 활용해 초기화

활용 사례

  • Claude Code나 Codex가 파일 전체를 읽지 않고 대규모 모노레포에서 관련 코드를 찾도록 지원
  • 임베딩을 모두 로컬 컴퓨터에서 실행해 소스 코드의 프라이버시 유지
  • AI 에이전트가 낯선 코드베이스를 탐색할 때 토큰 사용량 절감
  • 같은 프로젝트의 여러 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 파일을 확인하세요.

포함된 컬렉션

Claude Code용 MCP 서버로컬 LLM으로 코딩Claude Code 도구·스킬·플러그인MCP 서버로컬에서 LLM 실행하기

토픽

#code-search#semantic-search#mcp#claude-code#embeddings#local-llm#sqlite-vec#agentic-coding#claude#claude-ai

자주 묻는 질문

lumen은(는) 무엇인가요?
Ollama 또는 LM Studio 임베딩을 사용해 Claude Code, Codex, Cursor, OpenCode에 코드베이스의 의미 기반 검색을 제공하는 로컬 시맨틱 코드 검색 MCP 서버입니다. Lumen은 AI 코딩 에이전트를 위한 로컬 시맨틱 코드 검색 엔진입니다. 프로젝트의 벡터 인덱스를 구축하는 MCP 서버로 실행되므로, 에이전트는 파일 전체를 읽는 대신 semantic_search를 호출해 관련 함수, 타입, 모듈을 찾을 수 있습니다. 임베딩은 로컬 Ollama 또는 LM Studio 서버에서 생성하고 sqlite-vec를 사용하는 SQLite에 저장하므로, 코드가 컴퓨터 밖으로 나가지 않으며 클라우드 서비스나 외부 데이터베이스도 필요하지 않습니다.
lumen은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
lumen은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
lumen은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. lumen의 마지막 커밋은 2026년 10월 11일입니다.
lumen은(는) 어디에 사용할 수 있나요?
Claude Code나 Codex가 파일 전체를 읽지 않고 대규모 모노레포에서 관련 코드를 찾도록 지원 임베딩을 모두 로컬 컴퓨터에서 실행해 소스 코드의 프라이버시 유지 AI 에이전트가 낯선 코드베이스를 탐색할 때 토큰 사용량 절감 같은 프로젝트의 여러 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

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트