film-subtitles-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GROQ_API_KEY | Yes | Groq API 金鑰(免費)。到 https://console.groq.com/keys 申請,設定檔中必須提供才能執行轉錄與翻譯。 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| transcribe_startA | 把影片或音檔轉成字幕/逐字稿(開背景工作,立刻回傳 job_id)。 用在:影片上字幕、音檔轉文字、錄音轉逐字稿、演講/會議/課程影片轉文字、翻譯成中文字幕。 參數:
paths -- 影片或音檔的完整路徑,可給多個;也可以給整個資料夾。
language -- 音源語言。"en"=英文(產生英文逐字稿再翻成繁中字幕);
"zh"=中文(直接產生繁中字幕,會轉台灣繁體並校對錯字標點)。
translate -- True=要中文字幕;False=只要原文逐字稿。
translator -- "groq"(預設,只要 Groq 金鑰)或任何吃 產出會放在原檔案旁邊:<檔名>.en.srt(或 .zh.srt)與 <檔名>.zh-TW.srt。 回傳 job_id,用 transcribe_status 查進度。 |
| transcribe_statusB | 查某支轉字幕工作的進度、產出的字幕檔路徑,以及最近的執行訊息。 |
| transcribe_listC | 列出最近的轉字幕工作與各自狀態。 |
| check_setupA | 檢查這台電腦的環境是否齊備(ffmpeg、Groq 金鑰、翻譯後端)。裝完先跑這個。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool clearly targets a distinct operation: transcribe_start creates a job, transcribe_status queries one job, transcribe_list lists all recent jobs, and check_setup validates the environment. There is no overlap or ambiguity in purpose.
All tool names use consistent snake_case with a predictable verb_noun structure (transcribe_list, transcribe_start, transcribe_status, check_setup). The shared transcribe_ prefix for core operations and distinct check_setup for setup are logically organized.
Four tools is well-scoped for a focused background transcription service: one for environment check, one to start jobs, one to list jobs, and one to check status. No unnecessary tools and no obvious thinness for the core workflow.
The core lifecycle (setup check, start job, list jobs, poll status) is fully covered. Minor gaps exist, such as cancelling/deleting jobs or directly retrieving subtitle content via MCP, but agents can work around these by using returned file paths.