Chroma MCP Server

Chroma MCP Server

Una integración de servidor del Model Context Protocol (MCP) para Chroma, la base de datos de embeddings de código abierto.

Descripción general

Chroma MCP Server crea una "memoria de trabajo" persistente y consultable para el desarrollo asistido por IA:

• Recuperación automática de contexto: Los asistentes de IA pueden consultar información relevante de sesiones anteriores
• Persistencia gestionada por el desarrollador: Almacena decisiones e ideas clave en ChromaDB mediante MCP
• Integración de segundo cerebro: Se integra con flujos de trabajo de IDE para crear un centro de conocimiento unificado

Características principales:

• Indexación automatizada del código: Rastrea e indexa cambios en el código
• Registro automatizado de chats: Registra interacciones de IA con captura de contexto mejorada (diffs de código, secuencias de herramientas)
• Enlace bidireccional: Conecta discusiones con cambios de código para rastrear la evolución de funcionalidades
• Segmentación semántica de código: Preserva estructuras lógicas de código para una recuperación de contexto más significativa
• Herramientas de memoria de trabajo: Comandos MCP para capturar y recuperar contexto de desarrollo
• Sistema de validación: Validación basada en evidencia para cambios de código y promociones de aprendizaje
• Aprendizaje automatizado guiado por pruebas: Flujo de trabajo totalmente automatizado desde el fallo de prueba hasta la corrección verificada y la promoción de aprendizaje. Consulta la Guía de uso del plugin Pytest para integrar esto en tus proyectos.

Consulta la guía de inicio con tu segundo cerebro para más detalles.

Inicio rápido

Instalación

# Basic installation
pip install chroma-mcp-server

# Full installation with all embedding models
pip install "chroma-mcp-server[full]"

Ejecución

# With in-memory storage (data lost on restart)
chroma-mcp-server --client-type ephemeral

# With persistent storage
chroma-mcp-server --client-type persistent --data-dir ./my_data

Integración con Cursor

Añade o modifica .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "chroma": {
      "command": "uvx",
      "args": [
        "chroma-mcp-server"
      ],
      "env": {
        "CHROMA_CLIENT_TYPE": "persistent",
        "CHROMA_DATA_DIR": "/path/to/your/data",
        "CHROMA_LOG_DIR": "/path/to/your/logs",
        "LOG_LEVEL": "INFO",
        "MCP_LOG_LEVEL": "INFO",
        "MCP_SERVER_LOG_LEVEL": "INFO"
      }
    }
  }
}

Mejoras recientes

• Captura de contexto mejorada: Extrae automáticamente diffs de código, secuencias de herramientas y asigna puntuaciones de confianza
• Enlace bidireccional: Crea conexiones navegables entre discusiones de chat y cambios de código
• Segmentación semántica de código: Utiliza límites lógicos (funciones, clases) en lugar de segmentos de tamaño fijo
• Aplicación de marcas de tiempo en el servidor: Garantiza marcas de tiempo consistentes en todas las colecciones
• Creación automática de colecciones: Las colecciones esenciales (p. ej., chat_history_v1, codebase_v1) se crean automáticamente al iniciar el servidor si no existen.
• Sistema de registro mejorado: Los archivos de registro por ejecución evitan la contaminación de la comunicación JSON en modo stdio
• Gestión de funciones de embedding: Herramientas para actualizar los metadatos de la colección al cambiar las funciones de embedding
• Comando de configuración de colecciones: Simplifica la creación de múltiples colecciones con configuración consistente
• Flujo de trabajo de promoción automática: Promoción de aprendizaje derivado optimizada con manejo automático de entradas de alta confianza
• Valores predeterminados inteligentes: Promoción interactiva con valores predeterminados inteligentes para todos los campos según el contexto
• Advertencias de baja confianza: Indicadores visuales para entradas que pueden necesitar una revisión más cuidadosa
• Flujo de trabajo de pruebas automatizado: Captura totalmente automatizada de fallos de prueba, monitoreo de correcciones y promoción de aprendizaje validada

Documentación

La documentación completa está disponible en el directorio docs:

• Documentación principal - Guía completa de instalación, configuración y uso
• Primeros pasos - Instrucciones detalladas de configuración
• Guía para desarrolladores - Para colaboradores y desarrolladores
• Guías de integración con IDE y herramientas - Guías para integrar con IDEs y otras herramientas.
• Registro automatizado de chats - Historial de chat enriquecido con enlace bidireccional
• Guías de uso - Guías detalladas sobre cómo usar funciones y flujos de trabajo específicos.
• Captura de contexto mejorada - Detalles sobre la extracción de diffs de código y la secuenciación de herramientas
• Segmentación semántica de código - Segmentación de código que preserva la lógica para una recuperación significativa
• Flujo de trabajo de pruebas automatizado (uso del plugin Pytest) - Aprendizaje guiado por pruebas con validación automática
• Herramientas de pensamiento y utilidades - Documentación para herramientas de pensamiento estructurado y memoria.
• Scripts de cliente y desarrollador - Guías para herramientas CLI y scripts de desarrollador.
• Documentación de registro - Resumen de las funciones de registro y configuración.
• Registro del servidor - Detalles sobre el sistema de registro mejorado
• Documentación de automatización - Guías sobre automatización de tareas de desarrollo.
• Reglas y directrices del proyecto - Reglas de desarrollo, directrices y mejores prácticas.
• Planes de refactorización - Documentación sobre diversos esfuerzos de refactorización y planes arquitectónicos.
• Referencia de API - Herramientas y parámetros MCP disponibles

Licencia

Chroma MCP Server está licenciado bajo la Licencia MIT con la Cláusula Commons. Esto significa que puedes:

✅ Permitido:

• Usar Chroma MCP Server para cualquier propósito (personal, comercial, académico)
• Modificar el código
• Distribuir copias
• Crear y vender productos construidos con Chroma MCP Server

❌ No permitido:

• Vender Chroma MCP Server en sí
• Ofrecer Chroma MCP Server como servicio alojado
• Crear productos competidores basados en Chroma MCP Server

Consulta el archivo LICENSE.md para ver el texto completo de la licencia.