Archivos-DB-MCP: Búsqueda vectorial para proyectos de código

Un sistema de base de datos vectorial local que proporciona a los agentes de codificación LLM capacidades de búsqueda rápidas y eficientes para proyectos de software a través del Protocolo de control de mensajes (MCP).

Características

• Configuración cero : detecta automáticamente la estructura del proyecto con valores predeterminados razonables

• Monitoreo en tiempo real : vigila continuamente los cambios en los archivos

• Búsqueda vectorial : búsqueda semántica para encontrar código relevante

• Interfaz MCP : compatible con Claude Code y otras herramientas LLM

• Modelos de código abierto : utiliza modelos de caras abrazadas para incrustaciones de código

Related MCP server: MCPunk

Instalación

Opción 1: Clonar y configurar (recomendado)

Opción 2: Script de instalación automatizada

Uso

Después de la instalación, ejecute en cualquier directorio del proyecto:

El servicio permitirá:

1. Detecta tus archivos de proyecto

2. Iniciar la indexación en segundo plano

3. Comience a responder a las consultas de búsqueda de MCP de inmediato

Requisitos

• Estibador

• Docker Compose

Configuración

Files-DB-MCP funciona sin configuración, pero puedes personalizarlo con variables de entorno:

• EMBEDDING_MODEL - Cambia el modelo de incrustación (predeterminado: 'jinaai/jina-embeddings-v2-base-code' o modelo específico del proyecto)

• FAST_STARTUP - Establezca en 'verdadero' para utilizar un modelo más pequeño para un inicio más rápido (valor predeterminado: 'falso')

• QUANTIZATION - Habilitar o deshabilitar la cuantificación (valor predeterminado: 'verdadero')

• BINARY_EMBEDDINGS - Habilitar o deshabilitar incrustaciones binarias (predeterminado: 'false')

• IGNORE_PATTERNS - Lista separada por comas de archivos/directorios a ignorar

Primera puesta en marcha

En la primera ejecución, Files-DB-MCP descargará modelos de incrustación, lo que puede tardar varios minutos dependiendo de:

• El tamaño del modelo seleccionado (300-500 MB para modelos de alta calidad)

• La velocidad de tu conexión a Internet

Los inicios posteriores serán mucho más rápidos, ya que los modelos se almacenan en caché en un volumen Docker persistente. Para un inicio inicial más rápido, puede:

Almacenamiento en caché de modelos

Files-DB-MCP conserva automáticamente los modelos de incrustación descargados, por lo que solo necesita descargarlos una vez:

• Los modelos se almacenan en un volumen Docker llamado model_cache

• Este volumen persiste entre reinicios de contenedores y entre diferentes proyectos.

• El caché se comparte para todos los proyectos que utilizan Files-DB-MCP en su máquina

• No es necesario volver a descargar el modelo para cada proyecto

Integración de Claude Code

Añade a tu configuración de Claude Code:

Para obtener más detalles, consulte Integración de Claude MCP .

Documentación

• Guía de instalación : instrucciones de configuración detalladas

• Referencia de API : documentación completa de la API

• Guía de configuración - Opciones de configuración

Estructura del repositorio

• /src - Código fuente

• /tests - Pruebas unitarias y de integración

• /docs - Documentación

• /scripts - Scripts de utilidad

• /install - Scripts de instalación

• /.docker - Configuración de Docker

• /config - Archivos de configuración

• /ai-assist - Archivos de asistencia de IA

Licencia

Licencia MIT

Contribuyendo

¡Se agradecen las contribuciones! No dudes en enviar una solicitud de incorporación de cambios.