YouTube Music MCP Server

概述

该项目实现了一个模型上下文协议（MCP）服务器，使AI模型能够通过Google Chrome控制YouTube音乐播放。它弥合了AI助手与音乐播放之间的差距，允许AI根据歌曲名称和艺术家名称搜索并播放歌曲。

什么是MCP？

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

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

更多关于MCP的信息：

• MCP 文档
• MCP SDK

特性

• 在YouTube音乐中搜索歌曲
• 直接在Google Chrome中播放歌曲
• 支持根据歌曲名称和艺术家名称进行搜索
• 错误处理和日志记录
• 跨平台支持（专注于macOS上的Chrome自动化）

架构

高级概述

youtube-music-server MCP Server

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

• 使用URIs和元数据表示文本笔记的资源
• 创建新笔记的工具
• 生成笔记摘要的提示

特性

资源

• 通过note://URIs列出和访问笔记
• 每个笔记都有标题、内容和元数据
• 使用纯文本MIME类型以简单方式访问内容

工具

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

提示

• summarize_notes - 生成所有存储笔记的摘要
  • 包括所有笔记内容作为嵌入资源
  • 返回用于LLM摘要的结构化提示

开发

安装依赖项：

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服务器通过标准I/O进行通信，调试可能会比较困难。我们推荐使用MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。