字幕生成与翻译工具

mcp字幕

AI subtitle generation, translation, and formatting MCP server.
Transcribe audio to SRT, translate to any language, create bilingual subtitles, convert to ASS.
Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

中文文档

特性

• 转录到SRT --通过谷歌Chirp 2将音频/视频转换为带时间戳的SRT字幕
• 翻译字幕 --通过Google Translation API将SRT文件翻译成任何语言
• 双语字幕 --将原始文本和翻译文本合并到一个SRT文件中
• SRT到ASS --使用自定义字体、颜色和轮廓将SRT转换为样式化的ASS格式
• 单个API密钥 --一个 GEMINI_API_KEY 为转录和翻译提供动力
• 自动保存 --所有输出均以带时间戳的文件名保存到本地磁盘

建筑学

运作原理

Audio File --> transcribe_to_srt --> English SRT
                                       |
                              translate_srt --> Translated SRT
                                       |
                        create_bilingual_srt --> Bilingual SRT
                                       |
                              srt_to_ass --> Styled ASS

典型的工作流程是：将音频转录为SRT，可选择翻译，然后转换为ASS进行风格化播放。每个工具都是独立的——你也可以翻译现有的SRT，而无需先转录。

快速开始

1.克隆并安装

git clone https://github.com/kevinten-ai/mcp-subtitle.git
cd mcp-subtitle
uv sync

2.配置MCP

您需要一个GCP API密钥，该密钥已启用Speech-to-Text和TranslationAPI。

claude mcp add -s user mcp-subtitle \
  --env GEMINI_API_KEY=your_gcp_api_key \
  -- uv --directory /path/to/mcp-subtitle run subtitle-gen

{
  "mcpServers": {
    "mcp-subtitle": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-subtitle", "run", "subtitle-gen"],
      "env": {
        "GEMINI_API_KEY": "your_gcp_api_key"
      }
    }
  }
}

3.使用它

问你的AI助手：

"Transcribe this audio file to SRT subtitles: /path/to/audio.mp3"
"Translate the subtitles to Chinese"
"Create bilingual English-Chinese subtitles"
"Convert the SRT to ASS with yellow text"

工具（共4个）

转录_to_srt

使用Google Cloud语音转文本（Chirp 2）将音频/视频转录为SRT字幕文件。

translate_srt

使用Google Cloud Translation API将SRT字幕文件翻译为其他语言。

创建_双语_ srt

在一个SRT文件中创建包含原始+翻译文本的双语字幕。

srt_to_ass

使用可定制的样式将SRT转换为ASS格式。纯本地转换，不需要API。

API密钥设置

Google Cloud API密钥

步骤：

1. 创建GCP项目：https://console.cloud.google.com/projectcreate
2. 启用计费：https://console.cloud.google.com/billing
3. 启用API：
   • 语音转文本：https://console.cloud.google.com/apis/library/speech.googleapis.com
   • 云翻译：https://console.cloud.google.com/apis/library/translate.googleapis.com
4. 创建API密钥：https://console.cloud.google.com/apis/credentials
5. 集 GEMINI_API_KEY=your_key （mcp图像生成器和mcp视频生成器使用的密钥相同）

环境变量

故障排除

常见错误

API特定错误

SRT/ASS格式注释

• SRT时间格式： HH:MM:SS,mmm （毫秒前的逗号）
• ASS颜色格式： &HAABBGGRR （阿尔法、蓝色、绿色、红色——不是RGBA）
• ASS白色： &H00FFFFFF, ASS黄色： &H0000FFFF, ASS青色： &H00FFFF00
• 双语SRT： 每个块有两行——上面是原文，下面是译文

项目结构

src/subtitle_gen/
├── __init__.py       # Entry point
├── __main__.py       # python -m support
├── server.py         # MCP server + 4 tool handlers
├── stt.py            # Google Cloud STT helper (Chirp 2)
├── translator.py     # Google Cloud Translation v2 helper
└── formats.py        # SRT/ASS formatting utilities (pure Python)

本地开发

git clone https://github.com/kevinten-ai/mcp-subtitle.git
cd mcp-subtitle
uv sync

# Run directly
uv run subtitle-gen

# Debug with MCP Inspector
npx @modelcontextprotocol/inspector uv --directory . run subtitle-gen

相关项目

• mcp视频生成器 --AI视频生成MCP服务器（7个提供商+TTS+音乐）
• mcp图像生成器 --人工智能图像生成MCP服务器（Gemini+Imagen）
• mcp-3d-gen --AI 3D模型生成MCP服务器

许可证

麻省理工学院——见 许可证 了解详情。