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

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:

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)