# Servidor MCP para RedPanal

Este proyecto implementa un servidor MCP (Model Context Protocol) que permite interactuar con la API de RedPanal para listar, consultar detalles, descargar y subir audios.

## Requisitos

- Python 3.8 o superior
- [Poetry](https://python-poetry.org/) para la gestión de dependencias
- Una cuenta en [RedPanal](https://redpanal.org/) (solo necesaria para subir audios)

## Instalación

1. Clona este repositorio:

```bash
git clone <URL_DEL_REPO>
cd redpanal-mcp-server
```

2. Instala las dependencias:

```bash
poetry install
```

3. Crea un archivo `.env` en la raíz del proyecto con tus credenciales de RedPanal (solo necesarias para subir audios):

```
REDPANAL_USER=tu_usuario
REDPANAL_PASSWORD=tu_contraseña
```

## Uso

Utilizar con cliente desktop LLM como Claude (o equivalente)

y configurar servidor mcp por ejemplo en claude_desktop_config.json agregar:

    "redpanal": {
      "command": "uv",
      "args": [
        "--directory",
        "$YOUR_PATH/redpanal-mcp-server",
        "run",
        "mcp_redpanal.py"
      ]
    },
    


# El servidor expone las siguientes herramientas:

### 1. Listar audios

```python
list_audios(genre: str = None, tag: str = None, page: int = 1, page_size: int = 10)
```
Devuelve una lista de audios de RedPanal. Puedes filtrar por género, etiqueta, página y tamaño de página.

### 2. Obtener detalles de un audio

```python
get_audio_detail(audio_id: int)
```
Devuelve los detalles de un audio específico por su ID.

### 3. Subir un audio

```python
upload_audio(
    file_path: str,
    name: str,
    description: str,
    use_type: str,
    genre: str,
    instrument: str,
    tags: list
)
```
Sube un archivo de audio a RedPanal. Requiere autenticación (usuario y contraseña en el `.env`).

## Notas
- La subida de audios requiere que el usuario tenga permisos en RedPanal.
- El servidor utiliza la API pública de RedPanal para las consultas.