内容
# YouTube 转录文本 MCP 服务器
一款 FastMCP 服务器，旨在通过完整的视频网址或 11 位字符的视频 ID 获取 YouTube 视频转录文本。此服务器通过标准输入/输出（stdio）与 Cursor 等 AI 编程助手和代理无缝集成。
## 功能特点
- **灵活输入**：支持完整的 YouTube 观看网址、短链接（`youtu.be`）、嵌入式网址、短视频和原始 11 位字符视频 ID。
- **语言优先级**：允许指定备用语言代码列表（默认为英语和西班牙语）。
- **通用兼容性**：实现现代化的 `fetch()` 和 `.to_raw_data()` 模式，与底层转录库的 1.x 版本兼容。
## 前置条件
- Python 3.10 或更高版本
- 已配置的虚拟环境（`.venv`）
## 安装步骤
1. 将此存储库克隆到本地机器：
```bash
git clone https://github.com/JoseGonzalezAlonso/Local-MCP-server.git
cd Local-MCP-server
```
2. 创建并激活虚拟环境：
```bash
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
```
3. 安装依赖项：
```bash
pip install -r requirements.txt
```
## 使用方法
### 与 Claude Desktop 配合使用
在 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"youtube-transcript": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["/absolute/path/to/Local-MCP-server/src/server.py"]
}
}
}
```
### 与 Cursor 配合使用
在项目中的 `.cursor/mcp.json` 中添加：
```json
{
"mcpServers": {
"youtube-transcript": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["/absolute/path/to/Local-MCP-server/src/server.py"]
}
}
}
```
### 使用 MCP Inspector 在本地测试
```bash
mcp dev src/server.py
```
### 示例
连接后，向 AI 助手提问类似问题：
> 获取 https://www.youtube.com/watch?v=dQw4w9WgXcQ 的转录文本
`get_youtube_transcript` 工具接受：
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| `video_url_or_id` | `str` | 是 | 完整的网址、短链接、嵌入链接、短视频链接或原始视频 ID |
| `languages` | `list[str]` | 否 | 按优先级顺序排列的语言代码（默认值：`["en", "es"]`） |
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)
