Pepys

pepys-mcp

Transcrição para agentes de IA, por Pepys.

O servidor MCP de transcrição Pepys – forneça a qualquer agente que fale MCP (Claude, ChatGPT, Cursor, Gemini, agentes de código aberto) transcrição de áudio e vídeo com rótulos de falante e carimbo de tempo: diarização, legendas SRT/VTT, ingestão por colar link (YouTube, podcasts, Drive/Dropbox), lote e exportação em nível de palavra. A Pepys nunca treina com seu áudio.

O pacote roda localmente via stdio com uma chave de API Pepys. A Pepys também hospeda um conector OAuth de produção em https://pepys.co/api/mcp para clientes MCP remotos compatíveis.

Instalação e configuração

Requer Node ≥ 18 e uma chave de API Pepys (pk_live_…) de https://pepys.co/developers. Alguns recursos exigem uma permissão da conta.

Execute com npx (sem instalação global):

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

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

Cursor – ~/.cursor/mcp.json, mesma estrutura. Windsurf / outros agentes de desenvolvimento – aponte-os para npx -y pepys-mcp com PEPYS_API_KEY no ambiente.

Env opcional: PEPYS_API_BASE (padrão é https://pepys.co/api/v1).

Plugin Claude Code

Este repositório também inclui um plugin Claude Code que aponta para o conector OAuth hospedado (sem necessidade de chave de API):

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

A primeira chamada de ferramenta abre um login OAuth para sua conta Pepys. Veja skills/pepys/SKILL.md para saber o que ele pode fazer e exemplos de prompts.

Ferramentas

Ferramenta	O que faz
transcribe	Inicia uma transcrição a partir de um url (arquivo / YouTube / podcast / Drive) ou um file_ref. Opções: diarize (permissão necessária), summary, chapters, translate_to, quality, podcast episode_guid/episode_index. Retorna { job_id, status }.
get_transcription	Busca um job por job_id; defina wait_ms:25000 para long-poll de clipes curtos até a conclusão em uma única chamada.
upload_file	Envia mídia local (um path ou bytes_base64) → um file_ref para transcribe.
list_transcriptions	Jobs recentes (id, status, título, minutos).
list_podcast_episodes	Episódios de um feed RSS/Apple/Spotify, com episode_guids.
transcribe_podcast_feed	Processa um feed inteiro em lote (ou os últimos N). Permissão da conta necessária.
export_transcript	Exporta SRT / VTT / TXT / MD / JSON. Sincronização em nível de palavra exige permissão da conta. (DOCX/PDF: use o aplicativo web.)
search_transcript	Encontra uma frase em uma transcrição longa → apenas os segmentos correspondentes com carimbo de tempo (sem carregar o contexto completo da transcrição).
ask_transcription	Responde a uma pergunta sobre uma transcrição apenas com afirmações verificadas pelo servidor e com citações.
get_credit_balance	Saldo restante de transcrição e estado da permissão.

Também expõe transcrições concluídas como o recurso pepys://transcription/{id} e um prompt transcribe_and_summarize.

Limites da conta via MCP: 402 retorna um resultado de saldo insuficiente, enquanto recursos indisponíveis retornam um resultado claro de permissão e uma alternativa suportada quando existir. O servidor MCP não inicia compras nem vincula ao checkout.

Desenvolvimento

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

Publicação

npm run build && npm publish (publica pepys-mcp). Listagens de registro (registro MCP, mcp.so, Smithery, PulseMCP, Glama, awesome-mcp-servers) são enviadas separadamente.

Sobre

Construído por Pepys. Saiba mais em pepys.co · Servidor MCP · Documentação para desenvolvedores.

Licença

MIT