Skip to main content
Glama
alansmodic

Pocket Casts MCP Server

by alansmodic

Servidor MCP de Pocket Casts

Un servidor MCP que conecta asistentes de IA a tu cuenta de Pocket Casts. Explora tus suscripciones, lee detalles de episodios y recupera transcripciones, con transcripción automática a través de AssemblyAI cuando no existe una transcripción nativa.

Creado con Bun y FastMCP. Desplegable en Railway o cualquier host de Docker.

Herramientas

Herramienta

Descripción

list-podcasts

Lista todos los podcasts suscritos (incluye UUIDs de carpetas)

new-episodes

Obtiene episodios recientes de tus suscripciones

get-episode

Obtiene detalles sobre un episodio específico por UUID

get-transcript

Obtiene la transcripción de un episodio (recurre a AssemblyAI si no existe ninguna)

check-transcripts

Comprueba la disponibilidad de transcripciones en todos los podcasts o en una carpeta específica

Related MCP server: pocketcasts-mcp

Configuración

Requisitos previos

  • Bun v1.3+

  • Una cuenta de Pocket Casts (se requiere Plus para el acceso a la API)

Instalación y autenticación

bun install
bun run login

El comando de inicio de sesión solicitará tu correo electrónico y contraseña de Pocket Casts, y luego guardará los tokens en auth.json.

Configurar el entorno

Crea un archivo .env:

MCP_API_KEY=your-secret-key-here
ASSEMBLYAI_API_KEY=your-assemblyai-key    # optional, enables transcription fallback

Ejecución

bun run start

El servidor se inicia en el puerto 3001 (se puede sobrescribir con la variable de entorno PORT) utilizando transporte de flujo HTTP.

Conexión a un cliente MCP

Apunta tu cliente MCP a:

http://localhost:3001/mcp

Autentícate con:

  • Cabecera Authorization: Bearer <MCP_API_KEY>

  • Parámetro de consulta ?api_key=<MCP_API_KEY>

Despliegue en Railway

El Dockerfile incluido está listo para Railway. Configura estas variables de entorno en tu proyecto de Railway:

Variable

Requerido

Descripción

MCP_API_KEY

Sí

Token de portador para la autenticación del cliente MCP

POCKETCASTS_ACCESS_TOKEN

Sí

Desde auth.json después de iniciar sesión

POCKETCASTS_REFRESH_TOKEN

Sí

Desde auth.json después de iniciar sesión

POCKETCASTS_EXPIRES_AT

Sí

Desde auth.json después de iniciar sesión

ASSEMBLYAI_API_KEY

No

Habilita la transcripción para episodios sin transcripciones nativas

PORT

No

Railway configura esto automáticamente

Cómo funcionan las transcripciones

  1. Primero comprueba si existen transcripciones generadas por Pocket Casts

  2. Recurre a transcripciones obtenidas de RSS si están disponibles

  3. Si ninguna de las anteriores existe y ASSEMBLYAI_API_KEY está configurada, envía la URL del audio directamente a AssemblyAI para su transcripción (no se requiere descarga de archivos)

Related MCP Connectors

Related MCP Servers