AI导哈

YouTube音频控制服务

Tubist MCP Server是一个轻量级的macOS菜单栏播放器，允许通过AI助手自然语言控制YouTube音频播放，适用于背景音乐、播客等场景。

  • by dkasaj
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dkasaj/tubist-mcp-server

使用说明

Tubist MCP服务器

还记得上一次关闭标签页或退出浏览器时，YouTube音频突然停止。..？我打赌你一定很生气。

Tubist的存在是为了防止这种情况发生。 这是一个轻量级的macOS菜单栏播放器，可以让YouTube独立于浏览器运行。

Tubist可在Mac App Store免费下载.

此MCP服务器允许Claude和其他AI助手在助手的macOS应用程序要求时控制Tubist。

自然地问：

  • 演奏Billie Eilish Tiny Desk音乐会
  • 在YouTube上给我找一些爵士乐来集中注意力，然后在Tubist上播放
  • 在YouTube上寻找超级马里奥音乐的管弦乐渲染，并在Tubist中播放

特性

  • 🎬 只需一个简单的请求即可播放任何YouTube视频。..（除非它已经存在😞)
  • 🎵 非常适合背景音频（音乐会、播客、音乐）
  • 🤖 通过人工智能助手通过自然语言进行控制
  • ⚡ 即时播放-只需询问，即可播放，无需任何UI中断

先决条件/最低要求

安装

  1. 克隆此存储库：

    git clone https://github.com/dkasaj/tubist-mcp-server.git
cd tubist-mcp-server

  2. 安装依赖项：

    npm install

  3. 配置Claude桌面：

    编辑您的Claude Desktop配置文件：

    # On macOS
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

    添加Tubist MCP服务器，使用安装路径：

    {
  "mcpServers": {
    "Tubist - menu bar player for YouTube": {
 	 "command": "/opt/homebrew/bin/node",
 	 "args": ["/path/to/tubist-mcp-server/index.js"]
    }
  }
}

    重要提示： 替换 /path/to/tubist-mcp/index.js 使用您克隆此仓库的实际路径。

    找到你的Node.js路径：

    which node

    使用此路径而不是 /opt/homebrew/bin/node 如果不同。

  4. 重新启动克劳德桌面 完全（退出并重新打开，不要只是关闭窗口）

用法

配置后，您可以要求Claude自然播放YouTube视频：

示例：

  • “演奏Billie Eilish Tiny Desk音乐会”
  • “在YouTube上给我找一些爵士乐来集中注意力，然后在Tubist上播放”
  • “在YouTube上寻找超级马里奥音乐的管弦乐渲染，并在Tubist中播放”

运作原理

  1. 你向克劳德提出请求
  2. Claude使用MCP协议调用此服务器
  3. 服务器使用以下命令在Tubist中打开YouTube视频 tubist://play? URL方案
  4. 视频自动开始播放

故障排除

“MCP服务器已断开连接”错误

  • 检查路径是否正确 claude_desktop_config.json 是正确的
  • 使用验证Node.js路径 which node
  • 确保您完全重新启动了Claude Desktop

视频无法播放

  • 确保Tubis已安装并可以启动
  • 首先尝试手动打开Tubist以验证其是否正常工作
  • 检查YouTube URL是否有效。例如，克劳德有时会使用一个不再存在的视频链接。

工具未出现在Claude中

  • 确认配置文件是有效的JSON（使用JSON验证器）
  • 检查克劳德桌面日志： ~/Library/Logs/Claude/
  • 确保您保存了配置文件并重新启动了Claude

技术细节

此MCP服务器使用 Server 与一起上课 setRequestHandler 模式（而不是 McpServer.tool())由于MCP SDK 1.25.x中的一个已知错误，其中参数未正确传递给工具处理程序。

工具定义：

  • 姓名： play
  • 参数： url （YouTube视频URL）
  • 行动： 通过以下方式在Tubist中打开视频 tubist://play?[url] URL方案

贡献

欢迎投稿！请随时提交拉取请求。

许可证

麻省理工学院© 丹尼尔 卡西

链接

由...制作❤️ 用于背景YouTube收听

相关 MCP