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
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á:
- Detecta tus archivos de proyecto
- Iniciar la indexación en segundo plano
- 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
Contribuyendo
¡Se agradecen las contribuciones! No dudes en enviar una solicitud de incorporación de cambios.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Un sistema de base de datos vectorial local que proporciona a los agentes de codificación LLM capacidades de búsqueda semántica rápidas y eficientes para proyectos de software a través del Protocolo de control de mensajes.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.Last updated -61623JavaScriptMIT License
- AsecurityAlicenseAqualityChat with your codebase through intelligent code searching without embeddings by breaking files into logical chunks, giving the LLM tools to search these chunks, and letting it find specific code needed to answer your questions.Last updated -852PythonMIT License
- -securityFlicense-qualityA smart code retrieval tool based on Model Context Protocol that provides efficient and accurate code repository search capabilities for large language models.Last updated -20Python
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setupLast updated -11172PythonMIT License