YouTube Music MCP Server

YouTube Music MCP 服务

概述

本项目实现了一个 Model Context Protocol（MCP）服务，让 AI 模型能够通过 Google Chrome 控制 YouTube Music 播放。它连接了 AI 助手与音乐播放，使 AI 能够根据歌曲名称和艺人名称搜索并播放歌曲。

什么是 MCP？

Model Context Protocol（MCP）是一种标准化方式，用于让 AI 模型与外部工具和服务交互。它提供了一种结构化通信协议，使 AI 助手能够：

• 发现可用工具
• 了解工具功能
• 通过这些工具执行操作
• 以一致的方式处理响应和错误

了解更多 MCP 信息：

• MCP 文档
• MCP SDK

功能

• 在 YouTube Music 中搜索歌曲
• 直接在 Google Chrome 中播放歌曲
• 支持按歌曲名称和艺人名称搜索
• 错误处理和日志记录
• 跨平台支持（重点支持 macOS 上的 Chrome 自动化）

架构

高层概述

youtube-music-server MCP 服务

一个 Model Context Protocol 服务

这是一个基于 TypeScript 的 MCP 服务，实现了一个简单的笔记系统。它通过提供以下功能展示了 MCP 的核心概念：

• 表示文本笔记的资源，包含 URI 和元数据
• 用于创建新笔记的工具
• 用于生成笔记摘要的提示词

功能

资源

• 通过 note:// URI 列出和访问笔记
• 每条笔记都包含标题、内容和元数据
• 纯文本 MIME 类型，便于访问简单内容

工具

• create_note - 创建新的文本笔记
  • 将标题和内容作为必需参数
  • 将笔记存储在服务状态中

提示词

• summarize_notes - 生成所有已存储笔记的摘要
  • 将所有笔记内容作为嵌入式资源包含在内
  • 返回用于大模型摘要的结构化提示词

开发

安装依赖：

npm install

构建服务：

npm run build

开发时启用自动重新构建：

npm run watch

安装

要与 Claude Desktop 配合使用，请添加服务配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "youtube-music-server": {
      "command": "/path/to/youtube-music-server/build/index.js"
    }
  }
}

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它以 package script 的形式提供：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。