Whipscribe Mcp

io.github.neugence由 GitHub 帳號 neugence 發布v0.1.5更新於 Oct 24, 2026

Transcribe audio/video files or URLs via the WhipScribe cloud API and fetch the transcript.

已驗證STDIO僅桌面媒體與設計AI 與機器學習

概覽

AI 產生的概覽

把來自網址或本機檔案的音訊、影片送到 WhipScribe 雲端 API 轉錄，並取回逐字稿。

可以做什麼
  • 轉錄來自網址（YouTube、播客來源、直連檔案）或本機檔案的音訊與影片，可選語言、講者區分與字詞時間戳
  • 查詢執行中轉錄工作的進度
  • 以 txt、json、srt、vtt 或 docx 格式取得完成的逐字稿
  • 從本機快取瀏覽最近的工作
適用情境
適合讓助理把播客、影片連結或本機錄音轉成文字、字幕或文件，不必離開對話。此服務仍在測試階段，較適合實驗與個人工作流程，而非正式生產流程。
執行需求
以 Python 套件在本機執行（需 Python 3.10 以上），可透過 uvx、pipx 或 pip 安裝，並在用戶端設定為 stdio 伺服器。需要能連線至 WhipScribe API 的網路。WHIPSCRIBE_API_KEY 中的 API 金鑰為選用，未設定時每段錄音仍可取得免費預覽。另有選用變數可設定 API 位址、遙測以及輪詢逾時與間隔。
安裝前請注意
音訊、影片與網址會傳送到 WhipScribe 雲端服務處理。服務處於測試階段：介面、配額與額度可能變動，工作可能失敗或停滯，不適合轉錄失敗會造成法律、安全或財務後果的情境。匿名遙測預設開啟，可用 WHIPSCRIBE_MCP_TELEMETRY=0 關閉。付費額度需購買點數包或訂閱。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Whipscribe Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

whipscribe-mcp

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

MCP server for Whipscribe — transcribe audio and video from a URL or local file via Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.

⚠️ Beta service

  • whipscribe-mcp and the Whipscribe API are in beta. Endpoints, response shapes, and quotas may change without notice.
  • Jobs can fail, stall, or return partial output. Retry logic is your responsibility.
  • Beta credits can be invalidated without notice — e.g. for infrastructure migration, key compromise, or pricing reset. Beta credits do not convert to cash.
  • We will give 7 days' written notice before any pricing change that affects active keys, and honor unused credits at the old rate for 7 days after the notice.
  • Not suitable for production use cases where transcription failure has legal, safety, or financial consequences.
  • By installing and using this package, you accept the full terms at whipscribe.com/terms.

Install

bash
uvx whipscribe-mcp

Alternatives:

bash
pipx install whipscribe-mcppip install whipscribe-mcp

Requires Python 3.10+.

Claude Desktop

Add to claude_desktop_config.json:

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

Optional: set WHIPSCRIBE_API_KEY in env to unlock paid quota.

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

Restart Claude Desktop. Type "transcribe this podcast URL: …" and Claude will call the tool.

Tools

ToolDescription
transcribe_url(url, language?, diarize?, word_timestamps?)Transcribe audio/video from any URL (YouTube, podcast feeds, direct file links).
transcribe_file(path, language?, diarize?, word_timestamps?)Transcribe a local audio/video file.
get_job_status(job_id)Check progress of a running job.
get_transcript(job_id, format)Fetch the transcript in txt, json, srt, vtt, or docx.
list_recent_jobs(limit?)Browse your recent jobs (local cache).

All tools return a JSON object of the shape:

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": "..."}

On failure:

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

Environment variables

VariableRequiredDefaultPurpose
WHIPSCRIBE_API_KEYNo—API key (links jobs to your account and its credits; without it, every recording still gets a free preview)
WHIPSCRIBE_API_BASENohttps://whipscribe.com/api/v1Override API base URL (e.g. for staging)
WHIPSCRIBE_MCP_TELEMETRYNo1Set to 0 to disable anonymous usage telemetry
WHIPSCRIBE_MCP_POLL_TIMEOUT_SECONDSNo600Max seconds transcribe_url / transcribe_file waits before returning the job_id with a non-terminal status
WHIPSCRIBE_MCP_POLL_INTERVAL_SECONDSNo3Seconds between job-status polls during transcription

Privacy

Opt-in anonymous telemetry (on by default; disable with WHIPSCRIBE_MCP_TELEMETRY=0):

What we collect (metadata only):

  • Anonymous install hash: sha256(machine_id + salt)[:16]
  • Package version, OS, Python version
  • Tool name, duration in milliseconds, error code

What we never collect:

  • URLs you transcribe
  • Local file paths
  • API keys
  • Transcript text
  • Email or any personally identifying information

The anonymization algorithm is in this repo (src/whipscribe_mcp/telemetry.py). Inspect it. If it's not acceptable, turn it off.

Pricing

See whipscribe.com/pricing for current rates. Every recording gets a free preview, with or without an API key; credit packs start at $6 and never expire, and the Workspace plan is $19 a month (fair use 300 hours a month).

License

Apache License 2.0. Copyright 2026 Neugence Technology Pvt. Ltd.

Contact

來源：README.md，提交 9761718

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v0.1.5最新Oct 5, 2026
  2. v0.1.4Sep 29, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分