TranscriptFetch MCP Server

TranscriptFetch MCP 服务

一个 Model Context Protocol 服务，让任何 MCP 客户端（Claude Desktop、Cursor 等）都能访问 TranscriptFetch API：这是一个面向 YouTube、TikTok 和 Instagram 的生产级转录 API，缺少字幕时可使用 AI 转录。获取转录文本、搜索视频、列出频道和播放列表，并查看你的额度余额。

获取 API 密钥

1. 在 transcriptfetch.com 创建免费账号。无需银行卡。
2. 打开控制面板中的 API 密钥页面并创建密钥。密钥以 tf_live_ 开头。
3. 将密钥填入下方客户端配置中的 TRANSCRIPTFETCH_API_KEY。

每个账号每月可获得 50 个免费额度。失败请求不收费：如果获取结果中没有转录文本，则绝不会扣费。

服务在本地通过 stdio 运行，并使用你的密钥调用 TranscriptFetch API。更倾向于使用托管的远程服务？将客户端指向 https://transcriptfetch.com/mcp 即可（使用 OAuth 或 API 密钥）。托管服务会在内部等待短视频的 AI 转录完成，因此无需轮询。

工具

工具	功能
get_transcript	获取视频转录文本。支持 YouTube、TikTok、Instagram 或直接媒体 URL。设置 ai_fallback: true，在没有字幕时转录音频（短视频通常约需 30 秒，长视频耗时更久）
search_videos	按关键词搜索 YouTube
list_channel_videos	列出 YouTube 频道的视频（句柄、ID 或 URL）
list_playlist_videos	列出 YouTube 播放列表中的视频（ID 或 URL）
get_credits	查看此密钥的剩余额度。永不收费

按成功结果计费：获取字幕或视频列表需 1 个额度；音频 AI 转录每开始 5 分钟需 1 个额度，仅在交付结果时扣费。失败、受限及结果为空的请求均不收费，这对于短视频尤其重要，因为许多片段完全没有语音。

安装

无需安装。使用 npx 按需运行：

TRANSCRIPTFETCH_API_KEY=tf_live_... npx -y transcriptfetch-mcp

或全局安装：

npm install -g transcriptfetch-mcp

需要 Node 18+。

从源代码运行

git clone https://github.com/TranscriptFetch/mcp-server
cd mcp-server && npm install && npm run build

然后将客户端指向构建后的入口文件，设置 "command": "node"，并将 "args": ["/absolute/path/to/mcp-server/dist/index.js"] 作为参数。

客户端配置

Claude Desktop

将以下内容添加到 claude_desktop_config.json（依次选择 Settings、Developer、Edit Config）：

{
  "mcpServers": {
    "transcriptfetch": {
      "command": "npx",
      "args": ["-y", "transcriptfetch-mcp"],
      "env": { "TRANSCRIPTFETCH_API_KEY": "tf_live_..." }
    }
  }
}

Cursor

在 Cursor MCP 设置中的 mcpServers 下添加相同的配置块。

重启客户端后，五个工具就会显示出来。

示例

连接后，可以自然地向助手提问：

获取 https://youtu.be/aircAruvnKk 的转录文本并总结要点。

在 YouTube 上搜索“how transformers work”，并列出排名前 5 的视频。

列出 @lexfridman 的最新视频，并提取最新视频的转录文本。

我还剩多少 TranscriptFetch 额度？

助手会选择匹配的工具，并根据返回的转录文本或视频列表完成任务。

配置

环境变量	必需	默认值
TRANSCRIPTFETCH_API_KEY	是	无
TRANSCRIPTFETCH_BASE_URL	否	https://transcriptfetch.com

Docker

该服务通过 stdio 使用 MCP，因此无需开放端口。必须使用 -i： 如果没有连接标准输入，传输会立即关闭，容器看起来就像崩溃了一样。

docker build -t transcriptfetch-mcp .
docker run --rm -i -e TRANSCRIPTFETCH_API_KEY=tf_live_... transcriptfetch-mcp

链接

• API 文档：https://transcriptfetch.com/docs
• MCP 文档：https://transcriptfetch.com/docs/mcp
• Node SDK：https://github.com/TranscriptFetch/transcript-api-node
• Python SDK：https://github.com/TranscriptFetch/transcript-api-python

许可证

MIT