Pepys

pepys-mcp

Transcripción para agentes de IA, por Pepys – transcripción de audio y video de pago único en pepys.co.

El servidor MCP de transcripción de Pepys – permite que cualquier agente compatible con MCP (Claude, ChatGPT, Cursor, Gemini, agentes de código abierto) obtenga transcripciones precisas de horas de audio y video con etiquetado de hablantes y marcas de tiempo: diarización, subtítulos SRT/VTT con sincronización correcta, ingesta mediante enlace (YouTube, podcasts, Drive/Dropbox), procesamiento por lotes y exportación a nivel de palabra – un trabajo que un modelo general no puede hacer con un archivo en bruto. Pepys nunca entrena con tu audio.

Wrapper ligero de stdio sobre la API REST v1 de Pepys. Fase 1 (trae tu propia clave). OAuth/remoto está en la hoja de ruta.

Instalación y configuración

Requiere Node ≥ 18 y una clave de API de Pepys (pk_live_…) desde https://pepys.co/developers. Obtienes 60 minutos gratis al registrarte – sin tarjeta. Compra cualquier paquete una vez para desbloquear diarización, procesamiento por lotes y exportación a nivel de palabra.

Ejecútalo con npx (sin instalación global):

Claude Desktop / Claude Code – claude_desktop_config.json (o claude mcp add):

{
  "mcpServers": {
    "pepys": {
      "command": "npx",
      "args": ["-y", "pepys-mcp"],
      "env": { "PEPYS_API_KEY": "pk_live_your_key_here" }
    }
  }
}

Cursor – ~/.cursor/mcp.json, misma estructura. Windsurf / otros agentes de desarrollo – apúntalos a npx -y pepys-mcp con PEPYS_API_KEY en el entorno.

Env opcional: PEPYS_API_BASE (por defecto https://pepys.co/api/v1).

Herramientas

Herramienta	Qué hace
transcribe	Inicia una transcripción desde un url (archivo / YouTube / podcast / Drive) o un file_ref. Opciones: diarize (de pago), summary, chapters, translate_to, quality, podcast episode_guid/episode_index. Devuelve { job_id, status }.
get_transcription	Obtiene un trabajo por job_id; establece wait_ms:25000 para hacer polling largo en clips cortos hasta completarlos en una sola llamada.
upload_file	Sube medios locales (un path o bytes_base64) → un file_ref para transcribe.
list_transcriptions	Trabajos recientes (id, estado, título, minutos).
list_podcast_episodes	Episodios de un feed RSS/Apple/Spotify, con episode_guids.
transcribe_podcast_feed	Procesa por lotes un feed completo (o los últimos N). De pago.
export_transcript	Exporta SRT / VTT / TXT / MD / JSON. A nivel de segmento es gratis; word_level:true es un desbloqueo de pago. (DOCX/PDF: usa la aplicación web).
search_transcript	Busca una frase en una transcripción larga → solo los segmentos coincidentes con marcas de tiempo (sin cargar el contexto completo de la transcripción).
get_credit_balance	Minutos de crédito restantes + si Pro está desbloqueado.

También expone transcripciones finalizadas como el recurso pepys://transcription/{id} y un prompt de transcribe_and_summarize.

Facturación a través de MCP: dos avisos elegantes – 402 (sin minutos → recarga en pepys.co/billing) y un mensaje de actualización de funciones Pro (diarización / lotes / nivel de palabra → desbloquea con cualquier compra única). Las exportaciones de segmentos, transcripciones individuales, enlaces y subidas son gratis con tus minutos.

Desarrollo

npm install
npm run build      # tsc → dist/ (+ chmod the bin)
npm run smoke      # PEPYS_API_KEY=pk_live_… npm run smoke  – hits the live API to verify your key

Publicación

npm run build && npm publish (publica pepys-mcp). Los listados en registros (registro MCP, mcp.so, Smithery, PulseMCP, Glama, awesome-mcp-servers) se envían por separado.

Acerca de

Creado por Pepys – transcripción de pago único y basada en uso para audio y video (sin suscripción, los créditos nunca caducan). Aprende más en pepys.co · Servidor MCP · Documentación para desarrolladores · Precios.

Licencia

MIT