🚀 基于MCP的YouTube音乐服务器项目

本项目搭建了一个基于Model Context Protocol (MCP) 的服务器，借助该服务器，AI模型可通过Google Chrome对YouTube音乐播放进行控制。它成功搭建起AI助手与音乐播放的沟通桥梁，支持AI依据歌曲名称和艺术家名称搜索并播放歌曲。

🚀 快速开始

开发步骤

• 安装依赖：

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，它作为包脚本可用：

npm run inspector

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

✨ 主要特性

• 可在YouTube音乐中搜索歌曲。
• 能直接在Google Chrome中播放歌曲。
• 支持通过歌曲名称和艺术家名称进行搜索。
• 具备错误处理和日志记录功能。
• 支持跨平台（主要针对macOS的Chrome自动化）。

📚 详细文档

什么是MCP？

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

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

了解更多关于MCP的内容：

• MCP文档
• MCP SDK

架构

高级概述

YouTube音乐MCP服务器

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

• 通过note:// URI列表和访问带有元数据的文本笔记
• 每个笔记都有标题、内容和元数据
• 简单文本mime类型用于基本内容访问

工具

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

提示

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