Sobre el proyecto

Serena es un kit de herramientas del Protocolo de Contexto de Modelo (MCP) diseñado para proporcionar a los agentes de codificación de IA capacidades a nivel de IDE para la recuperación, edición, refactorización y depuración de código semántico. Opera a nivel de símbolos, aprovechando la estructura relacional del código, lo que permite a los agentes trabajar más rápido, de manera más eficiente y confiable, especialmente en bases de código grandes y complejas. Las características clave incluyen: - **Recuperación semántica**: Encuentra símbolos, obtén esquemas de archivos, encuentra símbolos de referencia, busca dependencias de proyectos, jerarquía de tipos, encuentra declaraciones e implementaciones, consulta proyectos externos y obtén diagnósticos. - **Refactorización**: Renombra símbolos, archivos y directorios; mueve símbolos/archivos/directorios; inserta en línea; y propaga eliminaciones para quitar código no utilizado. - **Edición simbólica**: Reemplaza cuerpos de símbolos, inserta antes/después de símbolos y elimina de forma segura, lo cual es menos propenso a errores y más eficiente en tokens que las alternativas basadas en texto. - **Depuración interactiva** (solo complemento de JetBrains): Establece puntos de interrupción, inspecciona variables, evalúa expresiones y controla el flujo de ejecución mediante una interfaz tipo REPL persistente. - **Utilidades básicas**: Búsqueda con expresiones regulares, reemplazo de texto, listado de directorios, lectura de archivos y ejecución de comandos de shell (a menudo deshabilitado por defecto en entornos de agentes como Claude Code o Codex). - **Gestión de memoria**: Un sistema de memoria simple para flujos de trabajo de agentes de larga duración, compartible entre sesiones, usuarios y proyectos. - **Configurabilidad**: Sistema de configuración YAML de múltiples capas con fragmentos de configuración globales, por proyecto, específicos del contexto de ejecución y componibles dinámicamente. Serena admite más de 40 lenguajes de programación mediante servidores de lenguaje (el backend gratuito y de código abierto por defecto) o mediante un complemento de pago de JetBrains (con prueba gratuita disponible) que aprovecha las capacidades de análisis del IDE. Se integra con cualquier cliente compatible con MCP, incluidos clientes de terminal (Claude Code, Codex, OpenCode, Gemini-CLI), IDEs (VSCode, Cursor, JetBrains) y clientes de escritorio/web (Claude Desktop, Codex App, OpenWebUI). La instalación requiere `uv` y se realiza mediante `uv tool install -p 3.13 serena-agent`, seguido de `serena init`. El proyecto está licenciado bajo GPL-3.0-o-posterior (con el componente SolidLSP bajo MIT).