Qdrant RAG MCP Server

Un servidor de búsqueda semántica para bases de código que utiliza Qdrant, con gestión inteligente de issues y proyectos de GitHub.

GitHub
9
Prueba este MCPPatrocinado

Documentación

Qdrant RAG MCP Server

Un servidor de Model Context Protocol (MCP) consciente del contexto que proporciona capacidades de búsqueda semántica en todo tu código utilizando la base de datos vectorial Qdrant. Ahora con resolución inteligente de issues de GitHub (v0.3.0), gestión de GitHub Projects V2 (v0.3.4) y soporte para sub-issues jerárquicos (v0.3.4.post4). Diseñado para funcionar perfectamente con Claude Code.

¿Por qué MCP RAG? Este servidor permite a los agentes de IA trabajar eficientemente con bases de código completas utilizando un 95%+ menos de tokens. Aprende cómo →

🌟 Características

🆕 Integración con GitHub (v0.3.0) + Projects V2 (v0.3.4) + Sub-Issues (v0.3.4.post4)

  • 🤖 Resolución inteligente de issues: Análisis de issues de GitHub impulsado por RAG y generación automatizada de correcciones
  • 🔄 Flujos de trabajo de extremo a extremo: Analiza issues → Genera correcciones → Crea PRs con seguridad de dry-run
  • 📋 Gestión de GitHub Projects V2: Crea proyectos, gestiona hojas de ruta, realiza seguimiento del progreso con paneles personalizados
  • 🎯 29 herramientas MCP de GitHub: Ciclo de vida completo de issues + 8 herramientas de gestión de proyectos + 5 herramientas de sub-issues mediante lenguaje natural
  • 📑 Sub-issues jerárquicos: Desglosa trabajo complejo con relaciones de issues padre/hijo
    • Lista, agrega, elimina, crea y reordena sub-issues
    • Agrega sub-issues en lote a Projects V2 con asignación inteligente de campos
    • Soporte de re-parentalización para reorganizar el trabajo
    • Conversión automática de número de issue a ID para un uso intuitivo
  • 💬 Comentarios en issues: Agrega comentarios a issues existentes para actualizaciones de flujo de trabajo y colaboración
  • 🧠 Asignación inteligente de proyectos: Asignación de campos mejorada con RAG basada en el análisis del contenido del issue
  • 📊 Plantillas de proyectos: Plantillas predefinidas para hojas de ruta, seguimiento de errores y planificación de funciones
  • 🔐 Autenticación flexible: Soporte para Personal Access Token y GitHub App
  • 📊 Análisis mejorado con RAG: Aprovecha la búsqueda completa en la base de código para comprender los issues
  • 🛡️ Diseño centrado en la seguridad: Modo dry-run, protección de archivos, limitación de velocidad y registro de auditoría

🆕 Seguimiento de contexto (v0.3.1)

  • 👁️ Visibilidad de la ventana de contexto: Monitorea lo que Claude sabe en la sesión actual
  • 📊 Seguimiento del uso de tokens: Estimaciones en tiempo real del consumo de la ventana de contexto
  • ⚠️ Advertencias de uso: Alertas automáticas al 60% y 80% de uso del contexto
  • 📈 Línea de tiempo de la sesión: Vista cronológica de todas las operaciones que consumen contexto
  • 💾 Persistencia de sesión: Guardado automático para análisis posterior
  • 🔍 Visor de sesiones: Utilidad para analizar patrones entre sesiones

🆕 Embeddings especializados (v0.3.3)

  • 🎯 Modelos específicos por tipo de contenido: Diferentes modelos de IA optimizados para distintos tipos de contenido
    • Código: Embeddings conscientes de programación para una relevancia de búsqueda de código 30-50% mejor
    • Config: Modelos conscientes de estructura para una navegación precisa en JSON/YAML/XML
    • Documentación: Embeddings optimizados para prosa en la búsqueda natural de documentación
  • 🧠 Comprensión específica por lenguaje: Modismos de Python, patrones de JavaScript y más
  • 🔥 Ruido entre tipos reducido: Las configuraciones no contaminan las búsquedas de código y viceversa
  • 🛡️ Seguro para subprocesos y confiable: Seguridad integral de subprocesos con protección de respaldo
  • 🍎 Optimizado para Apple Silicon: Gestión de memoria con aceleración MPS

🆕 Gestión progresiva de contexto (v0.3.2)

  • 🎯 Contexto multinivel: Jerarquía Archivo → Clase → Método para un uso óptimo de tokens
  • 💰 Reducción de tokens del 50-70%: Obtén vistas generales de alto nivel sin sacrificar el acceso a los detalles
  • 🧠 Detección de intención de consulta: Determina automáticamente el nivel de contexto adecuado para tu consulta
  • ⚡ Caché semántica: Consultas similares acceden a la caché con un umbral de similitud de 0.85
  • 🔄 Opciones de profundización: Comienza con una vista general, expande a detalles según sea necesario
  • 🏗️ Construcción inteligente de estructuras: Construye automáticamente jerarquías de código a partir de los resultados de búsqueda

Capacidades principales de RAG

  • 🎯 Consciente del contexto: Detecta y se limita automáticamente a tu proyecto actual
  • 🔍 Búsqueda híbrida: Combina comprensión semántica con coincidencia de palabras clave para una precisión +30% mejor
  • 🧠 Fragmentación basada en AST: Análisis de código consciente de la estructura para Python, Shell, Go, JavaScript y TypeScript (-40% tokens)
  • 🔗 Búsqueda consciente de dependencias: Incluye automáticamente archivos que importan o son importados por tus resultados de búsqueda (v0.1.9)
  • 📊 Contexto de búsqueda mejorado: Obtén automáticamente fragmentos de código circundantes para una mejor comprensión (v0.2.0)
  • 🎯 Clasificación multi-señal: Sistema de clasificación de 5 factores para una precisión de búsqueda 45% mejor (v0.2.1)
  • 📚 Indexación de documentación: Indexa y busca archivos de documentación markdown (v0.2.3)
  • ⚡ Reindexación incremental inteligente: Procesa solo los archivos modificados para una reindexación 90%+ más rápida (v0.2.4)
  • 📁 Soporte multiproyecto: Mantén separado el conocimiento de diferentes proyectos
  • 🚀 Ejecución local rápida: Soporta aceleración MPS de Apple Silicon
  • 🔧 Indexadores especializados: Análisis de código consciente del lenguaje y comprensión de archivos de configuración
  • 🔄 Auto-indexación opcional: Mantén tu índice actualizado automáticamente a medida que cambian los archivos
  • 📊 Registro consciente del proyecto: Separación automática de registros por proyecto con herramientas de depuración enriquecidas
  • 🏥 Monitoreo de salud: Comprobaciones de salud integradas con estado detallado del sistema

📚 Resumen de documentación

Documentación completa para configurar y usar el servidor Qdrant RAG con Claude Code.

🚀 Inicio rápido

Requisitos previos

  • Claude Code CLI
  • Docker
  • Python 3.10+ con uv (gestor de paquetes ultraviolet)

Instalación de uv (Ultraviolet)

Este proyecto utiliza uv para una gestión de paquetes de Python rápida y confiable. Si no lo tienes instalado:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with Homebrew
brew install uv

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

¿Por qué uv? Es 10-100x más rápido que pip y proporciona una mejor resolución de dependencias. Aprende más

Instalación

# 1. Clone the repository
git clone <repository-url> ~/mcp-servers/qdrant-rag
cd ~/mcp-servers/qdrant-rag

# 2. Run setup (starts Qdrant, installs dependencies)
./scripts/setup.sh

# 3. Install globally with context awareness (ONE TIME ONLY)
./install_global.sh

# That's it! The MCP server is now available in ALL projects

# 4. Test in any project
cd ~/any-project
claude
# Ask: "What's my current project context?"

Opcional: Habilitar auto-indexación

# For current session only
export QDRANT_RAG_AUTO_INDEX=true
claude

# For permanent auto-indexing
echo 'export QDRANT_RAG_AUTO_INDEX=true' >> ~/.bashrc
# or for zsh users:
echo 'export QDRANT_RAG_AUTO_INDEX=true' >> ~/.zshrc

🔧 Configuración del directorio de trabajo (¡Importante!)

El servidor MCP necesita conocer tu directorio de trabajo real para detectar correctamente los proyectos. Tienes tres opciones:

Opción 1: Lenguaje natural (¡Sin configuración requerida!)

Simplemente dile a Claude Code que establezca el directorio de trabajo al inicio de tu sesión:

"Get current directory with pwd, export MCP_CLIENT_CWD to that value, then run health check"

¡Esto funciona de inmediato sin ningún cambio de configuración!

Opción 2: Configuración mediante variable de entorno

En tu configuración de Claude Code (~/.claude-code/config.json):

{
  "mcpServers": {
    "qdrant-rag": {
      "command": "python",
      "args": ["/path/to/qdrant-rag/src/qdrant_mcp_context_aware.py"],
      "env": {
        "MCP_CLIENT_CWD": "${workspaceFolder}"
      }
    }
  }
}

Opción 3: Argumento de línea de comandos

{
  "mcpServers": {
    "qdrant-rag": {
      "command": "python",
      "args": [
        "/path/to/qdrant-rag/src/qdrant_mcp_context_aware.py",
        "--client-cwd",
        "${workspaceFolder}"
      ]
    }
  }
}

Nota: Sin una configuración adecuada del directorio de trabajo, el servidor puede detectar el proyecto incorrecto. El enfoque de lenguaje natural (Opción 1) es la forma más rápida de comenzar. Consulta la Guía de configuración de Claude Code para más detalles.

📖 Documentación

Guías principales

Documentación de referencia

Documentación técnica

📋 Guía de decisión rápida

Quiero...

⚡ Comandos rápidos

Configuración global (una sola vez)

# Run the installer - it handles everything
./install_global.sh

Uso diario

Indexación manual (predeterminada)

# Navigate to any project
cd ~/projects/my-app
claude

# In Claude:
# - Index: "Index all code files in this project"
# - Search: "Find authentication functions"
# - Context: "What's my current project context?"

🆕 Resolución de issues de GitHub (v0.3.0)

# In Claude with GitHub integration:
# - Setup: "Switch to repository owner/repo-name"
# - Create: "Create a test issue with title 'Bug in login' and labels 'bug'"
# - Analyze: "Analyze issue #123 using RAG search"
# - Fix: "Generate fix suggestions for issue #123"
# - Resolve: "Resolve issue #123 in dry-run mode"

🆕 Gestión de GitHub Projects V2 (v0.3.4)

# In Claude with GitHub Projects:
# - Create: "Create a roadmap project for Q1 2025"
# - Template: "Create a bug tracking project from template"
# - Add Items: "Add issue #123 to project with smart field assignment"
# - Status: "Show project #1 status with completion metrics"
# - Update: "Update issue #123 status to In Progress"
# - Custom Fields: "Create a priority field with High/Medium/Low options"

🆕 Gestión progresiva de contexto (v0.3.2)

# In Claude - use progressive context for token efficiency:
# - Overview: "What does the authentication system do?" (70% token reduction)
# - Navigation: "Find the DatabaseManager class" (50% token reduction)
# - Debugging: "Show me the bug in save_user function" (20% token reduction)
# - Explicit: "Search for logging with context_level=file"
# - Full detail: "Search for validate_user with progressive_mode=false"

# The system automatically:
# - Detects query intent (understanding vs debugging)
# - Uses semantic cache for similar queries
# - Provides drill-down options for deeper exploration

Con auto-indexación

# Enable for this session
export QDRANT_RAG_AUTO_INDEX=true
cd ~/projects/my-app
claude

# Files are automatically indexed as you work!
# Just search - no manual indexing needed

Reindexación (índice limpio)

# Use reindex when files have been:
# - Renamed or moved
# - Deleted
# - You see stale results

# In Claude:
# "Reindex this project" - Clears old data before indexing
# "Reindex the src directory" - Clean reindex of specific directory

# Regular index only adds new content
# Reindex removes old + adds new content

Búsqueda consciente de dependencias (v0.1.9+)

# In Claude - search with dependencies:
# "Search for 'validate_user' and include files that import it"
# "Find 'database connection' including dependent files"

# The include_dependencies parameter automatically:
# - Finds files that import the search results
# - Finds files imported by the search results
# - Shows related code for better understanding

✨ Características clave

Indexación mejorada

  • Indexador de código especializado: Análisis específico por lenguaje para más de 10 lenguajes de programación
  • Indexador avanzado de configuración: Soporte para archivos JSON, XML, YAML, TOML, INI, ENV
  • Fragmentación consciente de la estructura: Funciones, clases y secciones de configuración
  • Metadatos enriquecidos: Números de línea, importaciones, dependencias, extracción de esquemas

Patrones de archivos personalizados

  • Patrones predeterminados: Indexa automáticamente archivos comunes de código, configuración y documentación
  • Patrones personalizados: Especifica exactamente qué tipos de archivos indexar
  • Ejemplos de uso: 
    # In Claude Code
"Index directory with patterns *.sql *.graphql"
"Index only Rust files: *.rs *.toml Cargo.lock"
"Reindex with patterns *.proto *.pb.go for protobuf"
  • Patrones compatibles: Cualquier patrón glob (*.ext, specific-file.ext, etc.)

Fragmentación basada en AST (v0.1.5+)

  • Análisis consciente de la estructura: Utiliza Árboles de Sintaxis Abstracta para comprender la estructura del código
  • Unidades de código completas: Nunca divide funciones o clases por la mitad
  • Soporte multilenguaje: Python, JavaScript/TypeScript, scripts de Shell y Go
  • Metadatos jerárquicos: Rastrea relaciones (módulo → clase → método)
  • 40-60% menos fragmentos: Uso más eficiente de tokens preservando el significado
  • Características específicas por lenguaje:
    • Python: Clases, métodos, funciones con decoradores y docstrings
    • JavaScript/TypeScript: Módulos ES6, componentes React, funciones flecha (v0.1.8)
    • Shell: Extracción de funciones con preservación del código de configuración
    • Go: Paquetes, structs, interfaces con reglas de visibilidad

Búsqueda consciente de dependencias (v0.1.9+)

  • Inclusión automática de dependencias: Encuentra archivos que importan o son importados por tus resultados de búsqueda
  • Relaciones bidireccionales: Rastrea tanto importaciones como exportaciones en toda la base de código
  • Puntuación inteligente: Archivos relacionados incluidos con puntuaciones reducidas para mantener la relevancia
  • Resolución de importaciones: Maneja importaciones relativas y absolutas con resolución de rutas
  • Casos de uso:
    • Encuentra todos los archivos que usan una función o clase específica
    • Comprende el impacto de los cambios al ver el código dependiente
    • Rastrea el flujo de código a través de cadenas de importación
    • Descubre patrones de uso en tu proyecto

Búsqueda Híbrida (v0.1.4+)

  • Tres Modos de Búsqueda: Híbrido (predeterminado), solo vectorial, solo por palabras clave
  • Clasificación Inteligente: Combina coincidencias exactas de palabras clave con comprensión semántica
  • Transparencia de Puntuación: Vea contribuciones individuales (vector_score, bm25_score)
  • Modo Automático: La búsqueda híbrida funciona de inmediato para obtener los mejores resultados

Clasificación Mejorada (v0.2.1+)

  • 5 Señales de Clasificación: Combina múltiples factores para una relevancia óptima
    • Puntuación base (coincidencia semántica + de palabras clave)
    • Proximidad de archivos (impulso del mismo directorio)
    • Distancia de dependencias (relaciones de importación)
    • Similitud de estructura de código (funciones, clases)
    • Actualidad (modificaciones recientes priorizadas)
  • Pesos Configurables: Ajuste la clasificación para su flujo de trabajo mediante server_config.json
  • 45% Mejor Precisión: Mejora medida en la relevancia de búsqueda
  • Señales Visibles: Vea por qué los resultados se clasificaron como lo hicieron con ranking_signals
  • Guía de Configuración: Aprenda a personalizar la clasificación

Conciencia de Contexto

  • Detección Automática de Proyectos: Basada en .git, package.json, etc.
  • Aislamiento de Proyectos: Cada proyecto obtiene colecciones separadas
  • Alcance Inteligente: Las búsquedas se limitan por defecto al proyecto actual
  • Opción Entre Proyectos: Disponible cuando sea necesario

Optimización para Apple Silicon

  • Aceleración MPS: Soporte de Metal Performance Shaders para chips M1/M2/M3
  • Modo Local: Ejecución nativa en macOS para máximo rendimiento
  • Caché Inteligente: Almacenamiento y carga eficiente de modelos

Registro Consciente del Proyecto

  • Separación Automática de Registros: Registros organizados por proyecto, sin mezclas
  • Formato JSON Estructurado: Metadatos ricos para cada operación
  • Seguimiento de Rendimiento: Tiempos de operación y métricas de éxito
  • Utilidad de Visor de Registros: Busque, filtre y siga registros fácilmente
  • Niveles Configurables: Depure operaciones específicas según sea necesario

Fiabilidad y Seguridad

  • Lógica de Reintento de Conexión: Reintento automático con retroceso exponencial
  • Monitoreo de Salud: Verificación de salud integrada para todos los servicios
  • Indicadores de Progreso: Realice un seguimiento de operaciones de larga duración
  • Validación de Entrada: Prevención de recorrido de rutas y saneamiento
  • Mejor Manejo de Errores: Mensajes amigables con códigos de error

🔧 Arquitectura

Claude Code ←→ MCP Protocol ←→ Context-Aware RAG Server ←→ Qdrant Vector DB
                                        ↓
                               Project Detection
                                        ↓
                         Project-Specific Collections
                                        ↓
                              Specialized Indexers
                               (Code + Config)

Componentes del Servidor

Este proyecto incluye dos servidores distintos:

  1. Servidor MCP (src/qdrant_mcp_context_aware.py) - El servidor principal

    • Se integra directamente con Claude Code mediante stdio
    • Sin puerto de red - se comunica mediante stdin/stdout
    • Iniciado automáticamente por Claude Code cuando es necesario
    • Esto es lo que usa para la operación normal

  2. Servidor de Pruebas HTTP (src/http_server.py) - Interfaz de prueba opcional

    • Proporciona endpoints de API REST en el puerto 8081
    • Solo para probar la indexación/búsqueda sin Claude Code
    • No es necesario para el uso normal de Claude Code
    • Útil para depuración y pruebas de integración

🎯 Casos de Uso

Búsqueda de Código Impulsada por RAG

  • Búsqueda Semántica de Código: "Encuentra funciones de autenticación similares a UserService"
  • Descubrimiento de Configuración: "¿Dónde está configurada la conexión a la base de datos?"
  • Análisis de Patrones: "Muéstrame patrones de manejo de errores en este código base"
  • Comprensión de Código: "¿Cómo funciona el sistema de registro?"
  • Perspectivas Entre Proyectos: "Muéstrame implementaciones de JWT en todos mis proyectos"

🆕 Resolución de Problemas de GitHub (v0.3.0)

  • Análisis Inteligente de Problemas: "Analiza el problema #123 para entender el error y encontrar código relacionado"
  • Generación Automática de Correcciones: "Genera sugerencias de corrección para el problema de autenticación en #456"
  • Gestión de Repositorios: "Cambia a mi repositorio backend y muestra problemas abiertos"
  • Flujo de Trabajo de Problemas: "Crea un problema de prueba, analízalo y genera una corrección en modo simulado"
  • Creación de Solicitudes de Extracción: "Crea una PR para resolver el error de inicio de sesión con contenido automatizado"

🏥 Monitoreo de Salud

El servidor incluye una herramienta de verificación de salud para monitorear todos los servicios:

# In Claude Code
"Check health status"
"Run health check"

La verificación de salud informa:

  • Conexión a Qdrant: Estado y recuento de colecciones
  • Modelo de Incrustación: Nombre del modelo y verificación de dimensiones
  • Espacio en Disco: Almacenamiento disponible con advertencias
  • Uso de Memoria: Estado de la memoria del sistema (si psutil está instalado)
  • Contexto del Proyecto: Información del proyecto actual

Resiliencia de Conexión

El servidor reintenta automáticamente las operaciones fallidas:

  • Retroceso exponencial para fallos transitorios
  • Reconexión automática a Qdrant
  • Degradación gradual con mensajes de error claros

📊 Registro y Depuración

El servidor incluye registro integral consciente del proyecto para depuración y monitoreo.

Ver Registros

# View logs for current project
./scripts/qdrant-logs

# Follow logs in real-time
./scripts/qdrant-logs -f

# Filter by log level
./scripts/qdrant-logs --level ERROR

# Search logs
./scripts/qdrant-logs --search "index.*failed"

# View logs for specific project
./scripts/qdrant-logs --project /path/to/project

# Export logs for analysis
./scripts/qdrant-logs --export json > debug-logs.json

Ubicación de Registros

Los registros se almacenan en ~/.mcp-servers/qdrant-rag/logs/:

  • global/ - Inicio del servidor y operaciones que no son del proyecto
  • projects/ - Separados por proyecto con nombres amigables (por ejemplo, qdrant-rag_70e24d/)
  • errors/ - Errores críticos en todos los proyectos

Configuración

Controle el registro mediante variables de entorno:

export QDRANT_LOG_LEVEL=DEBUG        # Set log level
export QDRANT_LOG_DIR=/custom/path   # Custom log directory

🐛 Problemas Comunes y Soluciones

ProblemaSoluciónReferencia
MCP no disponible globalmenteAgregar con la bandera -s userGuía de Alcance MCP
Proyecto incorrecto detectadoVerifique los marcadores del proyectoGuía Consciente del Contexto
MPS no funcionaUse el modo localGuía MPS
Sin resultados de búsquedaIndexe primero, verifique el alcanceSolución de Problemas

📈 Mejoras Recientes

🚀 v0.3.3 (Última) - Incrustaciones Especializadas y Correcciones Críticas de Errores

  • ✅ Modelos Específicos por Tipo de Contenido: Diferentes modelos de incrustación para diferentes tipos de contenido
    • Código: nomic-ai/CodeRankEmbed (768D) - Incrustaciones conscientes de programación para búsqueda superior de código
    • Configuración: jinaai/jina-embeddings-v3 (1024D) - Consciente de estructura para archivos JSON/YAML/XML
    • Documentación: hkunlp/instructor-large (768D) - Optimizado para prosa en markdown/documentos
    • General: sentence-transformers/all-MiniLM-L12-v2 (384D) - Compatibilidad hacia atrás
  • ✅ 30-50% Mejor Búsqueda de Código: Las incrustaciones conscientes de programación entienden mejor el contexto del código
  • ✅ Gestión de Memoria Unificada: Optimizaciones para Apple Silicon con límites de memoria conservadores
  • ✅ Sistema de Registro de Modelos: Gestión central de modelos con verificación de compatibilidad
  • ✅ Scripts de Modelo Mejorados: download_models.sh mejorado con soporte de modelos especializados
  • ✅ Correcciones Críticas Posteriores al Lanzamiento (v0.3.3.post1-4):
    • Corregido Error Crítico de Búsqueda: Validación de tipo de payload que prevenía fallos de búsqueda
    • Corregido Error de Seguimiento de Contexto: Manejo de flotantes de configuración para seguimiento adecuado del contexto
    • 🔧 Corregido Desajuste de Dimensiones: Resuelto "Error de dimensión de vector: esperado dim: 768, obtenido 384"
      • Causa Raíz: Problemas de seguridad de hilos que causaban la expulsión del modelo CodeRankEmbed
      • Solución: Seguridad integral de hilos + lógica de respaldo compatible con dimensiones
      • Impacto: Los archivos de código ahora siempre obtienen incrustaciones 768D correctas
  • ✅ Reorganización del Conjunto de Pruebas: Categorización limpia (unidad/integración/rendimiento/depuración)
  • 📖 Guía de Gestión de Memoria: Detalles de optimización para Apple Silicon

v0.3.4 - Integración de GitHub Projects V2

  • ✅ Soporte de GitHub Projects V2: Integración completa de API GraphQL para gestión moderna de proyectos
  • ✅ 8 Nuevas Herramientas de Proyecto: Cree proyectos, agregue elementos, actualice campos, realice seguimiento del progreso
  • ✅ Asignación Inteligente de Campos: El análisis mejorado con RAG asigna automáticamente prioridad/estado/tipo
  • ✅ Plantillas de Proyecto: Plantillas preconstruidas para hojas de ruta, seguimiento de errores, planificación de funciones
  • ✅ Soporte de Campos Personalizados: Cree y gestione campos TEXT, NUMBER, DATE, SINGLE_SELECT
  • ✅ Paneles de Progreso: Métricas automáticas de finalización y seguimiento de estado
  • ✅ Patrón de Adaptador GraphQL: Separación limpia que preserva la funcionalidad REST existente
  • 📖 Guía de GitHub Projects: Guía completa con ejemplos y plantillas

v0.3.2 - Gestión Progresiva de Contexto

  • ✅ Recuperación de Contexto Multinivel: Jerarquía Archivo → Clase → Método para reducción de tokens del 50-70%
  • ✅ Caché Semántica: Consultas similares alcanzan la caché con umbral de similitud de 0.85
  • ✅ Detección de Intención de Consulta: Determina automáticamente el nivel de contexto óptimo
  • ✅ Canalización de Puntuación Configurable: Sistema de puntuación modular con etapas conectables
  • ✅ Tokenización BM25 Mejorada: Preprocesamiento específico de código (camelCase, snake_case)
  • ✅ Puntuación de Combinación Lineal: Puntuaciones de búsqueda híbrida más precisas (0.6-0.9 vs 0.01-0.02)

v0.3.1 - Seguimiento de Contexto

  • ✅ Visibilidad de la Ventana de Contexto: Monitoree lo que Claude sabe en la sesión actual
  • ✅ Seguimiento de Uso de Tokens: Estimaciones en tiempo real con advertencias al 60%/80%
  • ✅ Línea de Tiempo de Sesión: Vista cronológica de todas las operaciones que consumen contexto
  • ✅ Persistencia de Sesión: Guardado automático para análisis posterior

v0.3.0 - Integración de GitHub

  • ✅ 10 Herramientas MCP de GitHub: Gestión completa del ciclo de vida de problemas mediante Claude Code
  • ✅ Análisis de Problemas Impulsado por RAG: Aproveche la búsqueda en el código base para comprensión inteligente de problemas
  • ✅ Generación Automática de Correcciones: Genere correcciones de código con puntuación de confianza y plantillas
  • ✅ Flujos de Trabajo de Extremo a Extremo: Analizar → Generar → Crear PR con seguridad de modo simulado
  • ✅ Comentarios de Problemas: Agregue comentarios a problemas existentes para actualizaciones del flujo de trabajo
  • ✅ Autenticación Flexible: Soporte de Token de Acceso Personal y GitHub App
  • ✅ Pruebas de API HTTP: 10 nuevos endpoints bajo /github/ para pruebas e integración
  • ✅ Diseño con Seguridad Primero: Modo simulado, límites de velocidad, registro de auditoría, protección de archivos
  • ✅ Configuración Mejorada: Resolución fija de variables de entorno para mejor gestión de configuración
  • 📖 Guía de Integración de GitHub: Guía completa de configuración y uso de más de 700 líneas

v0.2.1 - Clasificación Mejorada

  • ✅ Clasificación Multiseñal: Los resultados de búsqueda ahora se clasifican por 5 factores configurables
  • ✅ Puntuación de Proximidad de Archivos: Impulsa resultados de directorios iguales/cercanos
  • ✅ Distancia de Dependencias: Prioriza archivos con relaciones de importación
  • ✅ Similitud de Estructura de Código: Agrupa patrones de código similares
  • ✅ Ponderación por Actualidad: Los archivos modificados recientemente aparecen primero
  • ✅ 45% Mejor Precisión: Mejora significativa en la relevancia de búsqueda
  • 📖 Guía de Configuración: Aprenda a ajustar la clasificación para su flujo de trabajo

v0.2.0 - Contexto Mejorado

  • ✅ Expansión Automática de Contexto: Obtenga fragmentos circundantes con resultados de búsqueda
  • ✅ Contexto Configurable: Controle cuánto contexto con el parámetro context_chunks
  • ✅ Herramienta Obtener Fragmentos de Archivo: Recupere archivos completos o rangos específicos de fragmentos
  • ✅ Tamaños de Fragmento Duplicados: Mejor comprensión semántica (código: 3000, configuración: 2000 caracteres)
  • ✅ 60% Menos Operaciones: Reducción de la necesidad de operaciones de seguimiento grep/read

v0.1.9

  • ✅ Búsqueda Consciente de Dependencias: Incluya automáticamente archivos que importan o son importados por resultados de búsqueda
  • ✅ Constructor de Grafo de Dependencias: Rastrea relaciones bidireccionales de importación/exportación en todo el código base
  • ✅ Comprensión Mejorada de Código: Vea cómo los módulos de código se relacionan y dependen entre sí

v0.1.8

  • ✅ Soporte de JavaScript/TypeScript: Análisis AST completo para archivos JS/TS incluyendo componentes React
  • ✅ Soporte de Módulos ES6: Maneja sintaxis moderna de importación/exportación y funciones de flecha
  • ✅ Cobertura de Lenguajes Ampliada: Ahora soporta 5 lenguajes con análisis AST

v0.1.7

  • ✅ Indexación de Scripts de Shell: Patrones predeterminados corregidos para incluir archivos .sh, .bash, .zsh
  • ✅ Mejor Soporte de Scripts: Manejo mejorado de scripts ejecutables

Lanzamientos Anteriores

  • ✅ Fragmentación Basada en AST: Análisis consciente de estructura para mejor comprensión de código (v0.1.5)
  • ✅ Búsqueda Híbrida: Búsqueda combinada vectorial + de palabras clave para 30% mejor precisión (v0.1.4)
  • ✅ Sistema Consciente de Contexto: Detección y alcance automáticos de proyectos
  • ✅ Instalación Global: Funciona en todos los proyectos con configuración adecuada
  • ✅ Soporte MPS: Aceleración GPU de Apple Silicon para incrustaciones más rápidas
  • ✅ Registro Consciente del Proyecto: Separación automática de registros y herramientas ricas de depuración
  • ✅ Reindexación Inteligente: Actualizaciones limpias de índice para prevenir datos obsoletos

¡Feliz codificación con búsqueda semántica consciente del contexto! 🎉