MCP Server
azuracast-mcp-server
luisitoys12/azuracast-mcp-server
45
InicialPluginScore · de 0 a 100MCP Server para AzuraCast - Controla tus estaciones de radio desde cualquier cliente MCP (Claude, n8n, Cursor, etc.)
Instalação
$
npx convez-ai luisitoys12/azuracast-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Estrelas
0Forks
0Acompanhando
0Saúde
28%Último commit
há 5 mesesVersão
—Issues abertas
0Contribuidores
1README
A tradução para o português deste README ainda está na fila.
azuracast-mcp-server
MCP Server para AzuraCast — controla y monitorea tus estaciones de radio desde Claude, n8n, Cursor y cualquier cliente MCP.
Herramientas disponibles
| Tool | Descripción |
|---|---|
get_nowplaying | Now playing actual (artista, título, portada, oyentes) |
get_song_history | Historial reciente de canciones |
list_stations | Lista todas las estaciones con ID y URL |
get_station | Detalles completos de una estación |
list_media | Lista archivos de media con metadata |
update_media_metadata | Actualiza artista, título, álbum, género y año de un track |
restart_station | Reinicia una estación |
skip_song | Salta la canción actual (requiere AutoDJ activo) |
🚀 Deploy en Render (recomendado)
El repo incluye un render.yaml listo. Sólo necesitas:
- Ve a dashboard.render.com → New → Blueprint.
- Conecta este repositorio:
luisitoys12/azuracast-mcp-server. - Render detecta el
render.yamlautomáticamente. - En la pestaña Environment, agrega:
AZURACAST_URL→https://radio.kusmedios.latAZURACAST_API_KEY→ tu API keyMCP_API_TOKEN→ se genera automáticamente (cópialo para tu cliente MCP)
- Da clic en Apply y espera el deploy.
Tu endpoint queda en:
https://azuracast-mcp-server.onrender.com/mcp
Configurar en Claude Desktop (modo remoto)
{
"mcpServers": {
"azuracast": {
"url": "https://azuracast-mcp-server.onrender.com/mcp",
"headers": {
"Authorization": "Bearer TU_MCP_API_TOKEN"
}
}
}
}
💻 Instalación local (modo stdio)
git clone https://github.com/luisitoys12/azuracast-mcp-server
cd azuracast-mcp-server
npm install
cp .env.example .env
# Edita .env con tu URL y API key
npm run build
Config Claude Desktop (modo local/stdio)
{
"mcpServers": {
"azuracast": {
"command": "node",
"args": ["/ruta/absoluta/azuracast-mcp-server/dist/index.js"],
"env": {
"AZURACAST_URL": "https://radio.kusmedios.lat",
"AZURACAST_API_KEY": "TU_API_KEY_AQUI"
}
}
}
}
🧩 Variables de entorno
| Variable | Requerida | Descripción |
|---|---|---|
AZURACAST_URL | Sí | URL base de tu AzuraCast (sin trailing slash) |
AZURACAST_API_KEY | Sí | API Key de AzuraCast |
MCP_API_TOKEN | No | Token Bearer para proteger el endpoint HTTP |
PORT | No | Puerto HTTP (Render lo inyecta automáticamente) |
⚠️ Nunca subas tu
.enva GitHub. Ya está en.gitignore.
Uso con n8n
- Agrega un nodo MCP Client.
- Tipo de conexión:
Streamable HTTP. - URL:
https://azuracast-mcp-server.onrender.com/mcp - Header:
Authorization: Bearer TU_MCP_API_TOKEN
Ejemplos de uso desde Claude
¿Qué está sonando ahora en la estación 4?
→ get_nowplaying({ station_id: 4 })
Muéstrame las últimas 20 canciones de kusmedios
→ get_song_history({ station_id: 4, rows: 20 })
Actualiza el artista del track 123 a "Adolescent's Orquesta"
→ update_media_metadata({ station_id: 4, media_id: 123, artist: "Adolescent's Orquesta" })
Licencia
MIT — hecho con ❤️ para EstacionKusmedios