Pepys

pepys-mcp

Transcripción para agentes de IA, por Pepys.

El servidor MCP de transcripción de Pepys – permite a cualquier agente compatible con MCP (Claude, ChatGPT, Cursor, Gemini, agentes de código abierto) obtener transcripciones de audio y video con etiquetas de hablante y marcas de tiempo: diarización, subtítulos SRT/VTT, ingesta mediante enlace (YouTube, podcasts, Drive/Dropbox), procesamiento por lotes y exportación a nivel de palabra. Pepys nunca entrena con tu audio.

El paquete se ejecuta localmente sobre stdio con una clave de API de Pepys. Pepys también ofrece un conector OAuth de producción en https://pepys.co/api/mcp para clientes MCP remotos compatibles.

Instalación y configuración

Requiere Node ≥ 18 y una clave de API de Pepys (pk_live_…) de https://pepys.co/developers. Algunas capacidades requieren un derecho de cuenta.

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.

Variables de entorno opcionales: PEPYS_API_BASE (por defecto https://pepys.co/api/v1).

Plugin de Claude Code

Este repositorio también incluye un plugin de Claude Code que apunta al conector OAuth alojado (no se necesita clave de API):

/plugin marketplace add ankurmans/pepys-mcp
/plugin install pepys

La primera llamada a una herramienta abre un inicio de sesión OAuth en tu cuenta de Pepys. Consulta skills/pepys/SKILL.md para ver qué puede hacer y ejemplos de indicaciones.

Herramientas

Herramienta	Qué hace
transcribe	Inicia una transcripción desde un url (archivo / YouTube / podcast / Drive) o un file_ref. Opciones: diarize (requiere derecho), 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 de 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). Requiere derecho de cuenta.
export_transcript	Exporta SRT / VTT / TXT / MD / JSON. La sincronización a nivel de palabra requiere un derecho de cuenta. (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).
ask_transcription	Responde una pregunta sobre una transcripción solo con afirmaciones verificadas por el servidor y respaldadas por citas.
get_credit_balance	Saldo de transcripción restante y estado de derechos.

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

Límites de cuenta a través de MCP: 402 devuelve un resultado de saldo insuficiente, mientras que las capacidades no disponibles devuelven un resultado claro de derechos y una alternativa compatible cuando existe. El servidor MCP no inicia compras ni enlaza al proceso de pago.

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. Más información en pepys.co · Servidor MCP · Documentación para desarrolladores.

Licencia

MIT