redpanal-mcp-server

hordiales/redpanal-mcp-server

3.2

If you are the rightful owner of redpanal-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project implements an MCP server to interact with the RedPanal API for audio management.

Tools

  1. list_audios

    Returns a list of audios from RedPanal with optional filters for genre, tag, page, and page size.

  2. get_audio_detail

    Fetches details of a specific audio by its ID.

  3. upload_audio

    Uploads an audio file to RedPanal, requiring user authentication.

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 para la gestión de dependencias
  • Una cuenta en RedPanal (solo necesaria para subir audios)

Instalación

  1. Clona este repositorio:
git clone <URL_DEL_REPO>
cd redpanal-mcp-server
  1. Instala las dependencias:
poetry install
  1. 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

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

get_audio_detail(audio_id: int)

Devuelve los detalles de un audio específico por su ID.

3. Subir un audio

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.