# StrudelMCP - Servidor Educativo de Composición Musical

Un servidor MCP (Model Context Protocol) construido con FastMCP que enseña a agentes de IA (como Copilot, Kiro, etc.) a componer música usando la sintaxis de Strudel, de la misma forma que se enseña a las personas.

## Objetivo Principal

Este proyecto no ejecuta Strudel directamente, sino que crea una **interfaz educativa** para que agentes de codificación aprendan composición musical mediante:

- **Lecciones estructuradas** de teoría musical y sintaxis Strudel
- **Ejemplos curados** de la comunidad con valoraciones y análisis
- **Análisis de patrones musicales** para entender qué hace que una melodía sea "buena"
- **Composición guiada** con retroalimentación y refinamiento iterativo

El resultado final son **composiciones libres de copyright** que puedes usar en tus proyectos (YouTube, podcasts, etc.) ejecutando el código Strudel generado por fuera del MCP.

## Casos de Uso

- **Creadores de contenido**: Genera música original para videos de YouTube sin preocuparte por copyright
- **Desarrolladores**: Enseña a tu agente de IA favorito a componer música
- **Educadores**: Herramienta para enseñar composición musical algorítmica
- **Músicos**: Explora nuevas ideas y patrones musicales

## Estado del Proyecto

✅ **COMPLETADO** - El servidor educativo está completamente funcional con todas las herramientas principales implementadas.

## Quickstart

### 1. Verificar Funcionamiento

```bash
python test_basic.py
```

### 2. Instalar FastMCP (Opcional)

```bash
pip install fastmcp
```

### 3. Ejecutar Servidor

```bash
python server.py
```

### 4. Ver Guía Completa

Consulta `GETTING_STARTED.md` para instrucciones detalladas de configuración con Kiro.

## Configuración en Kiro

Para usar este MCP server con Kiro, agrega esta configuración a tu `.kiro/settings/mcp.json`:

```json
{
  "mcpServers": {
    "strudel-music": {
      "command": "python",
      "args": ["path/to/strudel-mcp/server.py"],
      "disabled": false,
      "autoApprove": ["strudel_course", "analyze_audio", "example_repository"]
    }
  }
}
```

## Notas Técnicas

- El archivo `server.py` incluye mocks para permitir importación sin `fastmcp` instalada
- Para funcionalidad completa instale `fastmcp`: <https://gofastmcp.com/>
- Para ejecutar el código Strudel generado, instala Strudel REPL: <https://codeberg.org/uzu/strudel>