Pepys

pepys-mcp

为 AI Agent 提供转录服务，由 Pepys 提供。

Pepys 转录 MCP 服务——为任何支持 MCP 的 Agent（Claude、ChatGPT、Cursor、Gemini、开源 Agent）提供带说话人标签和时间戳的音频与视频转录：说话人分离、SRT/VTT 字幕、粘贴链接导入（YouTube、播客、Drive/Dropbox）、批量处理和逐词导出。Pepys 绝不会使用你的音频训练模型。

此软件包使用 Pepys API 密钥，通过 stdio 在本地运行。Pepys 还为兼容的远程 MCP 客户端提供生产环境 OAuth 连接器：https://pepys.co/api/mcp。

安装与配置

需要 Node ≥ 18 和一个从 https://pepys.co/developers 获取的 Pepys API 密钥（pk_live_…）。某些功能需要账户权限。

使用 npx 运行（无需全局安装）：

Claude Desktop / Claude Code – claude_desktop_config.json（或 claude mcp add）：

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

Cursor – ~/.cursor/mcp.json，格式相同。Windsurf / 其他开发 Agent – 将其指向 npx -y pepys-mcp，并在环境变量中设置 PEPYS_API_KEY。

可选环境变量：PEPYS_API_BASE（默认为 https://pepys.co/api/v1）。

Claude Code 插件

此仓库还附带一个 Claude Code 插件，指向托管的 OAuth 连接器（无需 API 密钥）：

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

首次调用工具时，会打开 OAuth 登录页面，让你登录 Pepys 账户。有关其功能和提示词示例，请参阅 skills/pepys/SKILL.md。

工具

工具	功能
transcribe	从 url（文件 / YouTube / 播客 / Drive）或 file_ref 开始转录。选项：diarize（需要账户权限）、summary、chapters、translate_to、quality、播客 episode_guid/episode_index。返回 { job_id, status }。
get_transcription	按 job_id 获取任务；设置 wait_ms:25000，即可通过长轮询在一次调用中等待短片段处理完成。
upload_file	上传本地媒体（path 或 bytes_base64）→ 返回供 transcribe 使用的 file_ref。
list_transcriptions	最近的任务（id、状态、标题、分钟数）。
list_podcast_episodes	获取 RSS/Apple/Spotify 源中的剧集及其 episode_guid。
transcribe_podcast_feed	批量处理整个源（或最新的 N 集）。需要账户权限。
export_transcript	导出 SRT / VTT / TXT / MD / JSON。逐词时间戳需要账户权限。（DOCX/PDF：请使用 Web 应用。）
search_transcript	在长篇转录文本中查找短语 → 仅返回匹配的带时间戳片段（不加载完整转录文本）。
ask_transcription	回答有关转录文本的问题，仅提供经服务端验证且带引用依据的内容。
get_credit_balance	查看剩余转录额度和账户权限状态。

还会将已完成的转录文本作为资源 pepys://transcription/{id} 暴露，并提供 transcribe_and_summarize 提示词。

MCP 账户限制： 402 会返回余额不足结果；不可用的功能会返回明确的账户权限提示，并在存在受支持的替代方案时提供该方案。MCP 服务不会发起购买，也不会链接到结账页面。

开发

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

发布

npm run build && npm publish（发布 pepys-mcp）。仓库列表（MCP registry、mcp.so、Smithery、PulseMCP、Glama、awesome-mcp-servers）需单独提交。

关于

由 Pepys 构建。了解更多信息，请访问 pepys.co · MCP 服务 · 开发者文档。

许可证

MIT