mcpField
W
whipscribe-mcp

whipscribe-mcp

本地服务
whipscribe.com媒体与设计13 周前更新
代码仓库访问官网

关于 whipscribe-mcp

whipscribe-mcp 是通过 WhipScribe 云端 API 转录音频和视频的 MCP 服务，适合需要处理本地文件或网络媒体的用户。它支持查询任务状态，并可获取多种格式的转录文本。

主要功能

  1. 01转录 URL 中的音视频
  2. 02转录本地音视频文件
  3. 03查询任务进度
  4. 04导出多种格式的转录文本
  5. 05查看近期任务

适用场景

  1. 01转录播客或在线视频
  2. 02整理本地录音和视频
  3. 03检查转录任务状态

MCP 相关

该 MCP 服务向兼容客户端提供音视频转录、任务状态查询和转录文本获取工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "neugence-whipscribe": {
      "command": "uvx",
      "args": [
        "whipscribe-mcp"
      ],
      "env": {
        "WHIPSCRIBE_API_KEY": "<WHIPSCRIBE_API_KEY>"
      }
    }
  }
}
启动命令uvx whipscribe-mcp
需要配置的环境变量
WHIPSCRIBE_API_KEY密钥WhipScribe API key (optional; unlocks paid quota, the anonymous free tier works without it)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypiwhipscribe-mcp0.1.5

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
urlstring是直接媒体 URL 或受支持的分享 URL。
diarizeboolean否在转录文本中标注说话人。
languagestring|null否ISO 639-1 语言代码（例如 'en'、'es'）。省略时自动检测。
word_timestampsboolean否包含逐词时间戳。

详细介绍

whipscribe-mcp

mcp-name: io.github.neugence/whipscribe-mcp

适用于 Whipscribe 的 MCP 服务 — 通过 Claude Desktop、Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端，从 URL 或本地文件转录音频和视频。

⚠️ Beta 服务
  • whipscribe-mcp 和 Whipscribe API 均处于 Beta 阶段。端点、响应格式和配额可能随时变更，恕不另行通知。
  • 任务可能失败、卡住或仅返回部分输出。重试逻辑由你负责。
  • Beta 积分可能会在不另行通知的情况下失效 — 例如基础设施迁移、密钥泄露或定价重置时。Beta 积分不能兑换现金。
  • 如果定价变更会影响有效密钥，我们会提前 7 天发出书面通知，并在通知后 7 天内按旧费率使用未用完的积分。
  • 不适用于转录失败会造成法律、安全或财务后果的生产场景。
  • 安装和使用此软件包即表示你接受 whipscribe.com/terms 上的完整条款。

安装

uvx whipscribe-mcp

其他方式：

pipx install whipscribe-mcp
pip install whipscribe-mcp

需要 Python 3.10+。

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "whipscribe": {
      "command": "uvx",
      "args": ["whipscribe-mcp"]
    }
  }
}

可选：在 env 中设置 WHIPSCRIBE_API_KEY 以解锁付费配额。

{
  "mcpServers": {
    "whipscribe": {
      "command": "uvx",
      "args": ["whipscribe-mcp"],
      "env": {
        "WHIPSCRIBE_API_KEY": "your-key"
      }
    }
  }
}

重启 Claude Desktop。输入“转录这个播客 URL：…”，Claude 就会调用该工具。

工具

工具描述
transcribe_url(url, language?, diarize?, word_timestamps?)转录任意 URL 中的音频/视频（YouTube、播客订阅源、直接文件链接）。
transcribe_file(path, language?, diarize?, word_timestamps?)转录本地音频/视频文件。
get_job_status(job_id)查看正在运行的任务进度。
get_transcript(job_id, format)获取 txt、json、srt、vtt 或 docx 格式的转录文本。
list_recent_jobs(limit?)浏览最近的任务（本地缓存）。

所有工具均返回以下格式的 JSON 对象：

{
  "ok": true,
  "job_id": "...",
  "status": "done",
  "transcript_preview": "first 300 chars...",
  "url_to_full": "https://whipscribe.com/view?id=...",
  "duration_sec": 967.3,
  "beta_notice": "..."
}

失败时：

{
  "ok": false,
  "error": {
    "code": "upload_failed",
    "message": "human-readable explanation",
    "retryable": true
  }
}

环境变量

变量必需默认值用途
WHIPSCRIBE_API_KEY否—API 密钥（将任务关联到你的账户及其积分；不设置时，每段录音仍可获得免费预览）
WHIPSCRIBE_API_BASE否https://whipscribe.com/api/v1覆盖 API 基础 URL（例如用于 staging）
WHIPSCRIBE_MCP_TELEMETRY否1设置为 0 可禁用匿名使用遥测
WHIPSCRIBE_MCP_POLL_TIMEOUT_SECONDS否600transcribe_url / transcribe_file 等待的最长秒数；超时后返回非终态状态的 job_id
WHIPSCRIBE_MCP_POLL_INTERVAL_SECONDS否3转录期间两次查询任务状态之间的间隔秒数

隐私

匿名遥测需选择启用（默认开启；设置 WHIPSCRIBE_MCP_TELEMETRY=0 可禁用）：

我们收集的内容（仅元数据）：

  • 匿名安装哈希：sha256(machine_id + salt)[:16]
  • 软件包版本、操作系统、Python 版本
  • 工具名称、耗时（毫秒）、错误代码

我们绝不会收集的内容：

  • 你转录的 URL
  • 本地文件路径
  • API 密钥
  • 转录文本
  • 电子邮件或任何可识别个人身份的信息

匿名化算法位于此仓库中（src/whipscribe_mcp/telemetry.py）。请检查该算法。如果你认为无法接受，请将其关闭。

定价

当前费率请参阅 whipscribe.com/pricing。每段录音均可获得免费预览，无论是否使用 API 密钥；积分包起价为 $6，且永不过期；Workspace 方案为每月 $19（合理使用额度为每月 300 小时）。

许可证

Apache License 2.0。版权所有 2026 Neugence Technology Pvt. Ltd.

联系方式

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。