Repolode
Enviar
ory

ory/lumen

Servidor MCP local de búsqueda semántica de código que permite a Claude Code, Codex, Cursor y OpenCode buscar por significado en tu base de código con embeddings de Ollama o LM Studio.

Ver en GitHubSitio web
Estrellas
315
Forks
37
Issues abiertos
29
Último commit
hace 26 días

¿Qué es?

Lumen es un motor local de búsqueda semántica de código para agentes de programación con IA. Se ejecuta como servidor MCP y crea un índice vectorial del proyecto, de modo que un agente puede llamar a semantic_search para encontrar funciones, tipos y módulos relevantes en vez de leer archivos completos. Los embeddings se generan con un servidor local de Ollama o LM Studio y se almacenan en SQLite con sqlite-vec, así que el código no sale de tu equipo y no se necesita ningún servicio en la nube ni una base de datos externa.

Los archivos se dividen en fragmentos semánticos mediante el AST nativo de Go para Go y gramáticas de tree-sitter para otros lenguajes. Un árbol de Merkle basado en hashes de archivos permite volver a generar embeddings solo para los archivos modificados en ejecuciones posteriores. Los worktrees de Git del mismo repositorio pueden compartir los datos del índice. Los índices se guardan en ~/.local/share/lumen, no dentro del repositorio.

El proyecto incluye plugins para Claude Code, Cursor, Codex y OpenCode. El README presenta resultados de benchmarks en tareas de corrección de errores en varios lenguajes, que muestran una reducción del costo y del uso de tokens sin perder calidad en los parches.

Funciones clave

  • 01Búsqueda semántica de funciones, tipos y módulos mediante una herramienta MCP
  • 02Indexación incremental que vuelve a generar embeddings solo para los archivos modificados mediante la comparación de árboles de Merkle
  • 03Embeddings locales con Ollama o LM Studio, sin depender de servicios en la nube
  • 04Almacenamiento en SQLite con sqlite-vec, fuera del directorio del proyecto
  • 05Compatibilidad con 12 familias de lenguajes mediante el AST de Go y analizadores de tree-sitter
  • 06Los worktrees de Git comparten los datos del índice y pueden inicializar nuevos worktrees a partir de los existentes

Casos de uso

  • Permitir que Claude Code o Codex encuentren código relevante en un monorepo grande sin leer archivos completos
  • Mantener la privacidad del código fuente al generar embeddings íntegramente en un equipo local
  • Reducir el uso de tokens cuando un agente de IA explora una base de código que no conoce
  • Agilizar el trabajo en varios worktrees de Git del mismo proyecto

Inicio rápido

  1. 1

    Instala Ollama y descarga el modelo de embeddings predeterminado

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

    Instala el plugin de Claude Code desde el marketplace

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

    Instala el plugin de Lumen en Claude Code

    /plugin install lumen@ory
  4. 4

    Inicia una nueva sesión de Claude y ejecuta la comprobación de estado

    /lumen:doctor

Antes de usarlo

  • Se necesita un servidor local de embeddings de Ollama o LM Studio en ejecución junto con el agente.
  • La licencia figura como NOASSERTION en los metadatos; consulta el archivo LICENSE antes de usarlo.

En colecciones

Servidores MCP para Claude CodeProgramar con LLM localesHerramientas, skills y plugins para Claude CodeServidores MCPEjecuta LLM en local

Temas

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

Preguntas frecuentes

¿Qué es lumen?
Servidor MCP local de búsqueda semántica de código que permite a Claude Code, Codex, Cursor y OpenCode buscar por significado en tu base de código con embeddings de Ollama o LM Studio. Lumen es un motor local de búsqueda semántica de código para agentes de programación con IA. Se ejecuta como servidor MCP y crea un índice vectorial del proyecto, de modo que un agente puede llamar a semantic_search para encontrar funciones, tipos y módulos relevantes en vez de leer archivos completos. Los embeddings se generan con un servidor local de Ollama o LM Studio y se almacenan en SQLite con sqlite-vec, así que el código no sale de tu equipo y no se necesita ningún servicio en la nube ni una base de datos externa.
¿lumen es gratuito? ¿Qué licencia tiene?
lumen es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿lumen sigue mantenido?
Mantenimiento activo. El último commit de lumen fue el 11 oct 2026.
¿Para qué puedo usar lumen?
Permitir que Claude Code o Codex encuentren código relevante en un monorepo grande sin leer archivos completos Mantener la privacidad del código fuente al generar embeddings íntegramente en un equipo local Reducir el uso de tokens cuando un agente de IA explora una base de código que no conoce Agilizar el trabajo en varios worktrees de Git del mismo proyecto
¿Cómo se instala lumen?
Instala Ollama y descarga el modelo de embeddings predeterminado: ollama pull ordis/jina-embeddings-v2-base-code Instala el plugin de Claude Code desde el marketplace: /plugin marketplace add ory/claude-plugins Instala el plugin de Lumen en Claude Code: /plugin install lumen@ory Inicia una nueva sesión de Claude y ejecuta la comprobación de estado: /lumen:doctor
¿Dónde consigo lumen?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ory/lumen

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados