Tubist MCP服务器
还记得上一次关闭标签页或退出浏览器时，YouTube音频突然停止。..？我打赌你一定很生气。
Tubist的存在是为了防止这种情况发生。 这是一个轻量级的macOS菜单栏播放器，可以让YouTube独立于浏览器运行。
此MCP服务器允许Claude和其他AI助手在助手的macOS应用程序要求时控制Tubist。
自然地问：
- _演奏Billie Eilish Tiny Desk音乐会_
- _在YouTube上给我找一些爵士乐来集中注意力，然后在Tubist上播放_
- _在YouTube上寻找超级马里奥音乐的管弦乐渲染，并在Tubist中播放_
特性
- 🎬 只需一个简单的请求即可播放任何YouTube视频。..（除非它已经存在😞)
- 🎵 非常适合背景音频（音乐会、播客、音乐）
- 🤖 通过人工智能助手通过自然语言进行控制
- ⚡ 即时播放-只需询问，即可播放，无需任何UI中断
先决条件/最低要求
- macOS 13（文图拉）及以上版本
- Tubist v1.3 已安装(Tubist可在Mac App Store免费下载.)
- Node.js 18.0.0或更高
- 克劳德桌面版 或另一个MCP兼容客户端
安装
- 克隆此存储库：
git clone https://github.com/dkasaj/tubist-mcp-server.git
cd tubist-mcp-server- 安装依赖项：
npm install- 配置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 如果不同。
- 重新启动克劳德桌面 完全（退出并重新打开，不要只是关闭窗口）
用法
配置后，您可以要求Claude自然播放YouTube视频：
示例：
- “演奏Billie Eilish Tiny Desk音乐会”
- “在YouTube上给我找一些爵士乐来集中注意力，然后在Tubist上播放”
- “在YouTube上寻找超级马里奥音乐的管弦乐渲染，并在Tubist中播放”
运作原理
- 你向克劳德提出请求
- Claude使用MCP协议调用此服务器
- 服务器使用以下命令在Tubist中打开YouTube视频
tubist://play?URL方案 - 视频自动开始播放
故障排除
“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收听