redpanal-mcp-server

audio-research-projects/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 dayong@mcphub.com.

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

Tools
3
Resources
0
Prompts
0

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.