justtranscribe-mcp

justtranscribe-mcp

JustTranscribe 的 MCP 服务 — 无需离开 AI 助手，即可将公开视频和音频转录为准确的带时间戳文本。在聊天中粘贴 YouTube、TikTok 或 Instagram 链接，即可获取转录文本、导出 SRT/TXT/Markdown，或提取社交视频的 AI 分析结果。系统会自动检测西班牙语、英语及数十种语言。

两种连接方式 — 都使用相同的 API 密钥和账户限额：

	传输方式	适用对象
托管版 https://justtranscribe.ai/api/mcp	Streamable HTTP	Claude Code、Cursor，以及任何支持带请求头远程服务的客户端
此软件包 npx justtranscribe-mcp	stdio	Claude Desktop 和其他仅支持 stdio 的客户端

设置

1. 在 https://justtranscribe.ai/api-keys 创建免费 API 密钥（测试阶段免费，无需信用卡）。
2. 将服务添加到客户端。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "justtranscribe": {
      "command": "npx",
      "args": ["-y", "justtranscribe-mcp"],
      "env": { "JUSTTRANSCRIBE_API_KEY": "jt_live_..." }
    }
  }
}

Claude Code（托管版 — 无需安装）：

claude mcp add --transport http justtranscribe https://justtranscribe.ai/api/mcp \
  --header "Authorization: Bearer jt_live_..."

Claude Code 插件

此仓库也是一个 Claude Code 插件。它会将此软件包作为本地 MCP 服务运行，并添加一个 transcribe 技能，其中包含限额和 导出格式相关信息。

/plugin marketplace add anthropics/claude-plugins-community
/plugin install justtranscribe@claude-community

设置一次密钥（在 https://justtranscribe.ai/api-keys 免费创建） 并重启 Claude Code：

export JUSTTRANSCRIBE_API_KEY=jt_live_...

然后：

/justtranscribe:transcribe https://www.youtube.com/watch?v=jNQXAC9IVRw

想通过登录而不是粘贴密钥？请直接使用托管服务，而非插件 — claude mcp add --transport http justtranscribe https://justtranscribe.ai/api/mcp — 该方式会启动 OAuth 登录。（插件的 .mcp.json 只会加载本地 stdio 服务，因此插件提供了 npx 版本。）

如需在插件上架前试用，请克隆此仓库并运行 claude --plugin-dir ./justtranscribe-mcp。

工具

• transcribe_url — 开始转录公开视频/音频链接（YouTube、 TikTok、Instagram、Facebook、Pinterest、Google Drive）。返回一个 ID； 处理需要几分钟。
• get_transcript — 按 ID 查询；完成后返回完整文本 （可选带时间戳的片段和 AI 分析结果）。
• list_transcripts — 查看账户的转录记录，按时间从新到旧排列。
• export_transcript — 将文本导出为 TXT、SRT、VTT、Markdown 或 CSV。
• delete_transcript — 永久删除转录记录及其媒体文件。
• get_account — 查看密钥所属账户及其限额。

限额

仅支持公开链接（不支持私密视频、需要登录的视频或直播），单条录制内容最长 150 分钟。服务执行与应用和 REST API 相同的限额：每个密钥每分钟 120 个请求、 每小时新建 3 条转录记录，测试阶段同一时间只能处理一条。 无法通过 MCP 上传文件 — 请使用应用或 REST API。

环境变量

• JUSTTRANSCRIBE_API_KEY（必需）— 你的 jt_live_… 密钥。
• JUSTTRANSCRIBE_API_URL（可选）— API 源站覆盖值；默认为 https://justtranscribe.ai。

MIT © Bramonti Ventures · 文档：https://justtranscribe.ai/mcp