🚀 基於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進行摘要