Skip to main content
Glama

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)

Related MCP server: SoundCloud MCP

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.

Available Tools

4 tools
download_sampleC

Downloads a sound from RedPanal.org by its url and converts it to a WAV Returns info_txt plus a JSON dump of a list with sound info.

Inputs: soundfile_url (required). Returns: result

get_audio_detailC

Get audio details by ID.

Inputs: audio_id (required).

list_audiosC

List audios from RedPanal with optional filters.

Inputs: genre, tag, page, page_size.

upload_audioC

Upload an audio file to RedPanal (requires auth).

Inputs: file_path (required), name (required), description (required), use_type (required), +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: download_sample downloads and converts a sound, get_audio_detail retrieves details by ID, list_audios lists with filters, and upload_audio uploads. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., download_sample, get_audio_detail, list_audios, upload_audio). No mixing of conventions.

    Tool Count4/5

    With 4 tools, the set is concise and not excessive. It covers core operations for a sound library, though it is on the minimal side but still appropriate for the scope.

    Completeness3/5

    The tool set covers listing, detail retrieval, upload, and download, but lacks update and delete operations for audio items, which are notable gaps for full lifecycle management.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables automated audio restoration, transcription, and speaker diarization via MCP tools for queuing files, monitoring progress, and retrieving speaker-labeled transcripts.
      9
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables podcast producers and agents to manage multitrack projects, run per-track transcription, perform transcript-driven edits, process audio via FFmpeg, and inspect a read-only DAW timeline over MCP.
      183
      MIT

    Appeared in Searches