Mondweep Youtube Music MCP Server

🚀 YouTube 音樂 MCP 服務器

本項目實現了一個模型上下文協議（MCP）服務器，能讓 AI 模型藉助 Google Chrome 控制 YouTube 音樂的播放。它在 AI 助手和音樂播放之間搭建了橋樑，支持 AI 根據歌曲名稱和藝術家名稱搜索並播放歌曲。

🚀 快速開始

此項目實現的 MCP 服務器可使 AI 模型通過 Google Chrome 控制 YouTube 音樂播放。你可以按照以下步驟進行開發和安裝：

開發步驟

• 安裝依賴：

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 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們建議使用 MCP 檢查器，它作為包腳本提供：

npm run inspector

檢查器將在瀏覽器中提供訪問調試工具的 URL。

✨ 主要特性

• 歌曲搜索：可搜索 YouTube 音樂中的歌曲，支持根據歌曲名稱和藝術家名稱進行搜索。
• 直接播放：能在 Google Chrome 中直接播放歌曲。
• 錯誤處理：具備錯誤處理和日誌記錄功能。
• 跨平臺支持：主要針對 macOS 的 Chrome 自動化，實現跨平臺支持。

📚 詳細文檔

什麼是 MCP？

模型上下文協議（MCP）是 AI 模型與外部工具和服務交互的標準方法。它提供了一種結構化的通信協議，使 AI 助手能夠：

• 發現可用工具
• 理解工具的功能
• 執行通過這些工具的動作
• 處理一致的響應和錯誤

瞭解 MCP 的更多信息：

• MCP 文檔
• MCP SDK

架構

高階概述

這是一個基於 TypeScript 的 MCP 服務器，展示了核心 MCP 概念，通過提供以下功能：

• 通過 note:// URI 列出和訪問文本筆記
• 每個筆記都有標題、內容和元數據
• 創建新筆記的工具
• 生成所有存儲筆記摘要的提示

功能詳情

資源

• 列出並通過 note:// URI 訪問筆記。
• 每個筆記具有標題、內容和元數據。
• 簡單文本 MIME 類型以獲取簡單內容訪問。

工具

• create_note - 創建新的文本筆記：
  • 使用標題和內容作為必需參數。
  • 在服務器狀態中存儲筆記。

提示

• summarize_notes - 生成所有存儲筆記的摘要：
  • 包括所有筆記內容作為嵌入式資源。
  • 返回用於 LLM 摘要的結構化提示。