Ytmp3 MCP

一个模型上下文协议（MCP）服务器，让你的人工智能下载YouTube音频和搜索视频——由 yt-dlp 和 ffmpeg，作为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"
      ]
    }
  }
}

更新操作系统的卷路径：

______________________________________________________________________

从源代码构建（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 文件夹，以视频标题命名。

支持的剪辑时间格式

______________________________________________________________________

运作原理

LLM client
    └── MCP call
            └── docker run  (or npx tsx)
                    └── yt-dlp + ffmpeg
                            └── ~/Downloads

每次工具调用都会生成一个新进程，运行命令并退出。没有持久容器，没有后台进程。

______________________________________________________________________

添加更多功能。。