Servidor de contexto de red

🔍 Potencie su asistente de codificación de IA con una comprensión profunda de la base de código .NET

NetContextServer permite a los asistentes de programación de IA, como VS Code, comprender a fondo su código .NET mediante el Protocolo de Contexto de Modelo (MCP) . Esto se traduce en sugerencias de código más precisas, mejores respuestas a sus preguntas y una experiencia de programación más productiva.

✨ Características principales

• Búsqueda de código semántico : encuentra código describiendo lo que estás buscando en lenguaje natural
• 🔍 Navegación inteligente : ayuda a las herramientas de IA a comprender la estructura y las dependencias de tu proyecto
• 🛡️ Seguridad incorporada : acceso seguro a archivos con protección automática de datos confidenciales
• Integración con VS Code : configuración perfecta con VS Code para una mejor asistencia en la codificación
• 📦 Análisis de paquetes : comprenda sus dependencias y obtenga recomendaciones de actualizaciones
  • 🔍 Visualización de dependencias profundas : vea dependencias transitivas con gráficos interactivos codificados por colores
  • 🧩 Agrupación inteligente : Agrupe visualmente los paquetes relacionados para una navegación más sencilla
  • 📊 Recomendaciones de actualización : Identifique paquetes obsoletos y problemas de seguridad
• 📊 Análisis de cobertura de pruebas : información detallada sobre la cobertura de sus pruebas
  • 🎯 Compatibilidad con múltiples formatos : analiza datos de cobertura de Coverlet, LCOV y Cobertura XML
  • 📈 Informes detallados : porcentajes de cobertura a nivel de archivo y seguimiento de líneas descubiertas
  • Cobertura de sucursales : Realice un seguimiento de la cobertura de sucursales a nivel de método cuando esté disponible
  • 💡 Recomendaciones inteligentes : obtenga sugerencias para mejorar la cobertura de las pruebas
• ⚡ Rápido y eficiente : indexación rápida y tiempos de respuesta para bases de código grandes

🚀 Inicio rápido

1. Clonar y construir :

2. Configurar (opcional, para búsqueda semántica):

3. Comience a usar :

👉 Lea nuestra Guía de inicio para obtener instrucciones de configuración detalladas y las mejores prácticas.

🔌 Integración con VS Code

1. Abrir Visual Studio Code
2. Presione Ctrl + Shift + P (o Cmd + Shift + P en macOS)
3. Escriba "Configurar servidor MCP"
4. Ingresar:

¡Ahora VS Code puede comprender tu código base! Intenta hacerle preguntas como:

• "Enumerar todos los archivos fuente .NET en este directorio del proyecto"
• "Buscar coincidencias de texto exactas en los archivos de código"
• Analizar los paquetes NuGet en todos los proyectos
• Obtener la lista actual de patrones ignorados
• "Agregue estos patrones de ignorancia: .generated.cs, bin/ "
• "Enumerar todos los archivos .csproj en este directorio"
• "Muéstrame el contenido de este archivo"
• "¿Cuál es el directorio base actual para las operaciones con archivos?"
• "Ayúdenme a pensar en el diseño del sistema de autenticación"
• "Documentar mi razonamiento sobre esta decisión arquitectónica"
• Analizar la cobertura de pruebas de MyService.cs
• "Muéstrame las líneas descubiertas en el módulo de autenticación"
• "¿Cuál es el porcentaje general de cobertura de la prueba?"
• "¿Qué archivos tienen la cobertura de prueba más baja?"

📚 Documentación

• Guía de inicio rápido : configuración rápida y primeros pasos
• Referencia de herramientas : documentación detallada de herramientas
• Guía de configuración : Opciones de configuración avanzadas
• Ejemplos de integración : uso con diferentes herramientas de IA
• Guía de contribución : Cómo ayudar a mejorar NetContextServer

Características

• 📁 Listado de proyectos y archivos : enumera todos los proyectos y archivos fuente de tu solución
• 🔍 Búsqueda de código : busca en tu base de código patrones o textos específicos
• 🧠 Búsqueda semántica : busque código según el significado, no solo coincidencias exactas de texto
• 📖 Acceso al contenido de archivos : lee archivos fuente con controles de seguridad y límites de tamaño
• 🛡️ Seguridad : protecciones integradas para archivos confidenciales y acceso a directorios
• 🎯 Gestión de patrones : ignora patrones flexibles para controlar el acceso a archivos
• 📊 Análisis de cobertura : analice y analice los datos de cobertura de las pruebas
  • Informes de cobertura : Compatibilidad con formatos Coverlet JSON, LCOV y Cobertura XML
  • Cobertura de línea : rastrea qué líneas están cubiertas por las pruebas
  • Cobertura de rama : Supervisar la cobertura de rama a nivel de método
  • 💡 Recomendaciones : Obtenga sugerencias prácticas para mejorar la cobertura
• 💭 Pensamiento Estructurado : Documentar y validar el razonamiento sobre operaciones complejas
  • Razonamiento optimizado por IA : basado en la investigación de Anthropic sobre la mejora de la resolución de problemas de LLM
  • 📋 Planificación de tareas : Divida los problemas complejos en pasos manejables
  • ✅ Cumplimiento de políticas : verificar las soluciones según las pautas del proyecto
  • 🔄 Análisis de resultados de herramientas : procese los resultados de otras herramientas antes de tomar las siguientes acciones
  • 📝 Documentación de decisiones : Mantener registros de auditoría de las decisiones arquitectónicas

Construyendo desde la fuente

1. Clonar el repositorio:

2. Construya la solución:

3. Ejecutar las pruebas (opcional):

Comandos de ejecución

Utilice el cliente para interactuar con su base de código:

Configuración del entorno

Para la funcionalidad de búsqueda semántica, debe configurar las siguientes variables de entorno:

• AZURE_OPENAI_ENDPOINT : la URL de su punto de conexión de Azure OpenAI
• AZURE_OPENAI_API_KEY : Su clave de API de Azure OpenAI

Uso

Comandos básicos

1. Establecer directorio base :

2. Obtener directorio base :

3. Obtener información de la versión :

4. Lista de proyectos :

5. Lista de archivos fuente :

6. Analizar paquetes :

Ejemplo de salida:

7. Analizar la cobertura de la prueba :

Ejemplo de resultado del análisis de cobertura:

Comandos de búsqueda

1. Búsqueda de texto :

2. Búsqueda semántica :

La función de búsqueda semántica:

• Utiliza incrustaciones para encontrar código según el significado
• Devuelve fragmentos de código clasificados por relevancia
• Muestra números de línea y puntuaciones de similitud
• Indexa automáticamente su código en la primera búsqueda

Gestión de patrones

1. Agregar patrones ignorados :

2. Ver patrones actuales :

3. Eliminar patrones específicos :

4. Patrones de usuario claros :

5. Ver ubicación del archivo de estado :

Patrones de ignorar predeterminados

Los siguientes patrones se ignoran de forma predeterminada para proteger la información confidencial:

• *.env - Archivos de entorno
• appsettings.*.json - Configuración de la aplicación
• *.pfx - Archivos de certificado
• *.key - Archivos de claves
• *.pem - Archivos PEM
• *password* - Archivos que contienen "contraseña" en el nombre
• *secret* - Archivos que contienen "secreto" en el nombre

Características de seguridad

1. Seguridad de ruta : solo se puede acceder a los archivos dentro del directorio base especificado
2. Validación de patrones : Ignorar los patrones validados para una sintaxis adecuada
3. Límites de tamaño : los contenidos de archivos grandes se truncan para evitar problemas de memoria
4. Protección de archivos confidenciales : los patrones integrados protegen los archivos confidenciales comunes

Ejemplo de flujo de trabajo

1. Establezca el directorio base para su proyecto:

2. Compruebe la versión y configuración del servidor:

3. Configurar patrones de ignoración personalizados:

4. Listado de todos los proyectos:

5. Analice las dependencias de los paquetes de su proyecto:

6. Buscar código relacionado con la autenticación:

Integración con herramientas de codificación de IA

NetContextServer implementa el Protocolo de contexto de modelo (MCP) , lo que permite una integración perfecta con asistentes de codificación de IA que admiten este protocolo, como:

• VS Code : proporciona a su asistente de IA el contexto completo de su base de código para una generación de código y asistencia más precisas.
• Otras herramientas compatibles con MCP : cualquier herramienta que implemente el Protocolo de contexto de modelo puede conectarse a NetContextServer

Para usar con VS Code:

1. Configurar VS Code para utilizar NetContextServer como su proveedor MCP
2. Disfrute de una asistencia de código mejorada con un contexto de base de código completo

Para probar y depurar las interacciones de MCP, puede usar el Inspector de Protocolo de Contexto de Modelo , una herramienta visual de pruebas que le ayuda a inspeccionar y validar las comunicaciones entre clientes y servidores de MCP. Consulte la documentación del inspector para obtener más información sobre sus características y capacidades.

NetContextServer permite que los colaboradores de IA soliciten información específica sobre su base de código, lo que hace que las sugerencias de la IA sean más relevantes y precisas para la estructura de su proyecto específico y sus patrones de codificación.

Manejo de errores

El servidor proporciona mensajes de error claros para escenarios comunes:

• Directorio no encontrado
• Acceso denegado (fuera del directorio base)
• Patrones no válidos
• Se excedieron los límites de tamaño de archivo
• Tipos de archivos restringidos
• Variables de entorno faltantes para la búsqueda semántica

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Confirme sus cambios
4. Empujar hacia la rama
5. Crear una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.