AI导哈

音频管理服务器

一个实现MCP协议的服务器，用于与RedPanal API交互，支持音频的列表查询、详情获取、下载和上传功能。

  • by audio-research-projects
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hordiales/redpanal-mcp-server

使用说明

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.

相关 MCP