Cómo Usar el Servidor Serena MCP

¡Hola! ¿Cansado de gastar dinero en herramientas de codificación de IA? Hablemos del Serena MCP Server, una joya gratuita y de código abierto que convierte tu LLM favorito en una potente herramienta de codificación, todo sin arruinarte. Desarrollado por Oraios AI, Serena te permite codificar de forma más inteligente con herramientas como Claude o modelos de peso abierto, ¿y lo mejor? ¡Puedes usarlo gratis! En esta guía, cubriremos qué es Serena, cómo instalarlo para un proyecto con Claude Code y cómo configurar el Serena MCP Server en Claude Desktop y Cursor. ¡Vamos a sumergirnos y ahorrarte algunas tarifas de suscripción!

¿Qué es el Serena MCP Server?

El Serena MCP Server es un kit de herramientas gratuito y de código abierto de Oraios AI que transforma cualquier modelo de lenguaje grande (LLM) en un agente de codificación completo. Utiliza el Protocolo de Contexto de Modelo (MCP) y el Protocolo de Servidor de Lenguaje (LSP) para proporcionar características similares a las de un IDE, como análisis de código semántico, edición a nivel de símbolo y soporte multilingüe (Python, JavaScript, Java y más). Ya sea que estés refactorizando código, analizando grandes bases de código o prototipando, Serena lo maneja todo, desde la planificación hasta la confirmación de cambios en el control de versiones.

¿Por qué es increíble? Serena nació de la frustración con las costosas suscripciones de IDE como Cursor o Windsurf y herramientas con muchas API como Claude Code o Cline. Oraios AI quería una alternativa gratuita que funcionara con los LLM que ya tienes, como Claude de Anthropic (¡incluso en el nivel gratuito!) o modelos de peso abierto a través de Agno. Es su regalo a la comunidad de desarrolladores, y ellos mismos lo usan a diario. Además, tiene licencia MIT, por lo que puedes personalizarlo a tu gusto.

Instalando Serena en un proyecto con Claude Code

Vamos a hacer que el Serena MCP Server funcione en tu proyecto usando Claude Code, un popular asistente de codificación que soporta servidores MCP de forma gratuita. Aquí te explicamos cómo configurarlo:

Paso 1: Instalar requisitos previos

1. Instalar uv:

• Serena usa uv (un gestor de paquetes de Python) para ejecutarse. Instálalo mediante:

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

# Para usuarios de Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

O usa Homebrew: brew install uv.

2. Clonar el repositorio de Serena:

• Obtén el código base de Serena desde GitHub:

git clone https://github.com/oraios/serena
cd serena

3. Configurar el entorno:

• Copia el archivo de entorno de ejemplo:

cp .env.example .env

• No se necesitan claves API para el nivel gratuito de Claude, pero si usas un modelo de pago, añade su clave a .env.

Paso 2: Configurar Serena para Claude Code

1. Iniciar el servidor MCP:

• Ejecuta el servidor MCP de Serena directamente desde el repositorio:

uv run serena start-mcp-server

Esto inicia un servidor local con un panel web en http://localhost:24282/dashboard/index.html para registros y apagado.

2. Añadir Serena a Claude Code:

• En tu terminal, añade Serena como un servidor MCP a Claude Code:

claude mcp add-json "serena" '{"command":"uvx","args":["--from","git+https://github.com/oraios/serena","serena-mcp-server"]}'

Esto le indica a Claude Code que use el servidor MCP de Serena sin instalación local.

3. Pruébalo:

• Abre Claude Code, inicia una nueva conversación y escribe:

Analiza mi base de código Python en ./src.

• Serena escaneará tu proyecto, almacenará recuerdos en .serena/memories/ y proporcionará un análisis detallado. Prueba:

Refactoriza main.py para usar async/await.

• ¡Observa cómo Serena sugiere cambios de código precisos!

Solución de problemas

• ¿El servidor no se inicia? Asegúrate de que uv esté instalado y de que el archivo .env esté configurado. Revisa los registros del panel.
• ¿Errores de Claude Code? Verifica la sintaxis del comando MCP y reinicia Claude Code.
• ¿Problemas de permisos? Usa rutas absolutas (por ejemplo, /ruta/a/serena) para evitar errores de rutas relativas.

Usando el Serena MCP Server en Claude Desktop

Claude Desktop es otra excelente manera de usar el Serena MCP Server de forma gratuita, aprovechando el nivel gratuito de Claude. Aquí te explicamos cómo conectarlo:

Paso 1: Configurar el servidor MCP

1. Ejecutar el servidor MCP de Serena:

• En el directorio del repositorio de Serena, inicia el servidor:

uv run serena start-mcp-server

O usa Docker (Experimental) para una configuración más limpia:

docker run --rm -i --network host -v /ruta/a/tus/proyectos:/workspaces/projects ghcr.io/oraios/serena:latest serena start-mcp-server --transport stdio

Reemplaza /ruta/a/tus/proyectos con la ruta absoluta de tu proyecto.

2. Editar la configuración de Claude Desktop:

• Abre el archivo de configuración de Claude Desktop:
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Añade el servidor MCP de Serena:

{
  "mcpServers": {
    "serena": {
      "command": "/ruta/a/uv",
      "args": ["run", "--directory", "/ruta/a/serena", "serena-mcp-server"]
    }
  }
}

Reemplaza /ruta/a/uv y /ruta/a/serena con las rutas reales (usa dobles barras invertidas \\ en Windows).

3. Reiniciar Claude Desktop:

• Cierra y vuelve a abrir Claude Desktop. Verás un icono de martillo que indica que las herramientas de Serena están activas.

Paso 2: Probar Serena en Claude Desktop

1. Iniciar una conversación:

• En Claude Desktop, escribe:

Resume mi proyecto en ./myproject.

• Serena analizará tu base de código y devolverá un resumen, utilizando su comprensión semántica impulsada por LSP.

2. Probar tareas de codificación:

• Pregunta:

Corrige errores en src/app.js basándote en los registros.

• Serena sugerirá correcciones, basándose en los registros y en la memoria de su proyecto en .serena/memories/.

3. Revisar el panel:

• Visita http://localhost:24282/dashboard/index.html para monitorear los registros o apagar el servidor.

Consejos

• Habilitar registro: En myproject.yml, establece show_logs: true para facilitar la depuración.
• Control de versiones: Añade .serena a .gitignore para evitar la confirmación de archivos de memoria.
• Seguridad: Evita execute_shell_command en modo Agno sin confirmación para prevenir acciones no deseadas.

Usando el Serena MCP Server en Cursor

Cursor es un IDE elegante impulsado por IA, y puedes usar el Serena MCP Server con Cursor de forma global o por proyecto. Aquí te explicamos cómo:

Paso 1: Configurar el servidor MCP de Serena

1. Iniciar el servidor:

• Como antes, ejecuta:

uv run serena start-mcp-server

O usa el comando Docker de la sección de Claude Desktop.

2. Configurar Cursor globalmente:

• Abre ~/.cursor/mcp.json (en la sección "Herramientas e integraciones"):

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/oraios/serena", "serena-mcp-server"]
    }
  }
}

Esto hace que Serena esté disponible en todos los proyectos de Cursor.

3. O configurar por proyecto:

• En la raíz de tu proyecto, crea .cursor/mcp.json con la misma configuración que la anterior.

4. Reiniciar Cursor:

• Cierra y vuelve a abrir Cursor para aplicar los cambios.

Paso 2: Probar Serena en Cursor

1. Abrir el panel de chat de Cursor:

• En un proyecto, abre el panel de chat y escribe:

Genera una API REST en src/api.py.

• Serena creará código, respetando la estructura de tu proyecto.

2. Refactorizar código:

• Resalta el código, presiona Ctrl+L (o Cmd+L en macOS) y escribe:

Optimiza esta función para mejorar el rendimiento.

• Serena sugerirá mejoras, pero ten en cuenta que el modo de edición puede ser limitado sin una suscripción Pro.

3. Revisar registros:

• Usa el panel web (http://localhost:24282/dashboard/index.html) para solucionar problemas.

¿Por qué usar el Serena MCP Server?

El Serena MCP Server es un salvavidas para los desarrolladores hartos de los costos de suscripción. Aquí te explicamos por qué es genial:

• Gratis para siempre: Funciona con el nivel gratuito de Claude o modelos de peso abierto a través de Agno, sin necesidad de claves API.
• Funciones potentes: La recuperación de código semántico, las ediciones a nivel de símbolo y el soporte multilingüe rivalizan con herramientas de pago como Cursor.
• Respetuoso con la privacidad: Se ejecuta localmente, manteniendo tu base de código fuera de servidores de terceros.
• Impulsado por la comunidad: Con más de 2.9k estrellas en GitHub y desarrollo activo, Serena mejora rápidamente.

Los usuarios están entusiasmados con Serena, y algunos lo llaman "la configuración de codificación más potente" cuando se combina con Claude. Ya seas un desarrollador individual o parte de un equipo, Serena te permite cancelar esas costosas suscripciones y codificar de forma más inteligente. Pronto, ChatGPT Desktop podría admitir servidores MCP, ampliando aún más tus opciones.

Conclusión

El Serena MCP Server es tu boleto a la codificación gratuita impulsada por IA con herramientas como Claude Code, Claude Desktop y Cursor. Desde la instalación de Serena hasta su ejecución en tu editor favorito, ahora estás equipado para abordar tareas de codificación sin los dolores de cabeza de las suscripciones. ¡Pruébalo, explora su panel web y déjame saber en los comentarios cómo estás usando Serena para potenciar tu flujo de trabajo!