使用说明
一个模型上下文协议（MCP）服务器，让你的人工智能下载YouTube音频和搜索视频——由
yt-dlp和ffmpeg，作为Docker镜像发布。
它做什么
| 工具 | 说明 |
|---|---|
download_audio |
从任何YouTube URL下载MP3格式的音频。支持时间范围剪裁。 |
search_videos |
搜索YouTube并返回标题、频道、持续时间和网址 |
更多工具即将推出。
需求
- Docker 桌面版 --Docker使用
- Node.js 18+——直接通过npm/npx运行
yt-dlp和ffmpeg安装在您的系统上——用于npm使用
重要
如果您想下载播放列表，请将以下内容保留为“系统提示”
When a tool returns a list of video URLs, you MUST immediately call download_audio for each URL one by one without asking for confirmation or summarizing. Do not stop until every URL has been passed to download_audio.
Docker（推荐，无需设置）
1.拉取图像
docker pull piyush9969/ytmp3-mcp:latest
2.添加到MCP客户端配置
{
"mcpServers": {
"ytmp3-mcp": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-v", "/Users/yourname/Downloads:/downloads",
"-e", "DOWNLOADS_DIR=/downloads",
"piyush9969/ytmp3-mcp:latest"
]
}
}
}
更新操作系统的卷路径：
| OS | 卷路径 |
|---|---|
| Mac | /Users/yourname/Downloads:/downloads |
| Linux | /home/yourname/Downloads:/downloads |
| 窗户 | C:/Users/yourname/Downloads:/downloads |
从源代码构建（Docker）
如果你想自己构建图像而不是拉：
git clone https://github.com/miteoshi/ytmp3-mcp.git
cd ytmp3-mcp
docker build -t ytmp3-mcp .
然后使用相同的 mcp.json 如上所述，但替换图像名称：
{
"mcpServers": {
"ytmp3-mcp": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-v", "/Users/yourname/Downloads:/downloads",
"-e", "DOWNLOADS_DIR=/downloads",
"ytmp3-mcp"
]
}
}
}
直接通过npm运行（无Docker）
需要 yt-dlp 和 ffmpeg 安装在您的计算机上：
雨衣：
brew install yt-dlp ffmpeg
窗户：
winget install yt-dlp ffmpeg
Linux：
sudo apt install ffmpeg
pip install yt-dlp
然后克隆并安装：
git clone https://github.com/miteoshi/ytmp3-mcp.git
cd ytmp3-mcp
npm install
添加到MCP客户端配置中：
{
"mcpServers": {
"ytmp3-mcp": {
"command": "npx",
"args": [
"tsx",
"/path/to/ytmp3-mcp/src/index.mts"
]
}
}
}
替换 /path/to/ytmp3-mcp 使用克隆仓库的实际路径。
LM Studio配置位置
Settings → LLM → MCP Servers → Edit config
用法
一旦连接，只需自然地与您的法学硕士交谈：
Download the audio from https://www.youtube.com/watch?v=...
Download only 1:00 to 2:30 from https://www.youtube.com/watch?v=...
Search YouTube for "baby keem new music"
下载的文件将显示在您的 ~/Downloads 文件夹，以视频标题命名。
支持的剪辑时间格式
| 格式 | 示例 |
|---|---|
MM:SS |
1:30 |
HH:MM:SS |
00:01:30 |
| 秒数 | 90s |
运作原理
LLM client
└── MCP call
└── docker run (or npx tsx)
└── yt-dlp + ffmpeg
└── ~/Downloads
每次工具调用都会生成一个新进程，运行命令并退出。没有持久容器，没有后台进程。
添加更多功能。。
