Spotify MCP Server 4ox

🚀 Spotify MCP 服務器

Spotify MCP（媒體控制協議）服務器是一款用於管理和控制 Spotify 音樂播放的工具。它提供了多種交互方式，如 Web 界面、命令行界面和語音控制，極大地提升了用戶管理音樂播放的便捷性。

🚀 快速開始

先決條件

• 安裝 Node.js 和 npm
• 註冊 Spotify 開發者賬號並獲取 Client ID 和 Secret

設置步驟

1. 安裝依賴項

npm install

2. 創建配置文件 在項目根目錄下創建 .env 文件，添加以下內容：

PORT=8000
BRIDGE_PORT=9000
VOICE_PORT=8001
CLIENT_ID=your_spotify_client_id
CLIENT_SECRET=your_spotify_client_secret

3. 啟動服務器

npm start

✨ 主要特性

• Web 界面：通過瀏覽器訪問服務器，輕鬆控制音樂播放。
• 命令行界面：在終端中使用命令靈活操作 Spotify 播放。
• AI 助手集成：支持與 AI 助手（如 Claude）集成，實現語音控制。
• 語音控制：通過麥克風輸入指令，便捷控制音樂播放。
• API 接口：提供 RESTful API，方便開發者擴展功能。

📦 安裝指南

安裝依賴

npm install

配置環境

在項目根目錄創建 .env 文件，並按如下內容配置：

PORT=8000
BRIDGE_PORT=9000
VOICE_PORT=8001
CLIENT_ID=your_spotify_client_id
CLIENT_SECRET=your_spotify_client_secret

啟動服務

npm start

💻 使用示例

基礎用法

Web 界面

打開瀏覽器訪問 http://localhost:8000，按照提示完成 Spotify 認證。

命令行界面

• 播放音樂：

npm run play

• 暫停播放：

npm run pause

• 切換歌曲：

npm run next

高級用法

使用 curl 發送請求

• 獲取當前播放信息：

curl http://localhost:8000/api/currently-playing

• 播放音樂：

curl -X POST http://localhost:8000/api/play

• 暫停播放：

curl -X POST http://localhost:8000/api/pause

📚 詳細文檔

API 端點

• 獲取當前播放信息：

GET /api/currently-playing

• 播放音樂：

POST /api/play

• 暫停播放：

POST /api/pause

AI 助手集成

設置觸發詞

在語音控制界面中，進入設置菜單，輸入您喜歡的觸發詞（例如“小愛同學”），然後保存。

語音控制

1. 在終端中啟動語音服務器：

node speech/voice-server.js

2. 打開瀏覽器訪問 http://localhost:8001，進入語音控制界面。
3. 點擊麥克風按鈕，開始錄音並輸入指令（例如“小愛同學，播放音樂”）。

運行所有服務

創建一個名為 start-all.js 的文件：

const { spawn } = require('child_process');

const mcp = spawn('npm', ['start'], { stdio: 'inherit' });
setTimeout(() => {
  const bridge = spawn('node', ['bridge/claude-spotify-bridge.js'], { stdio: 'inherit' });
  const voice = spawn('node', ['speech/voice-server.js'], { stdio: 'inherit' });
}, 1000);

運行：

node start-all.js

🔧 技術細節

開發模式

npm run dev

故障排除

端口已使用錯誤

• 檢查是否有其他程序佔用目標端口。
• 修改 .env 文件中的端口號。

認證失敗問題

• 確保 Client ID 和 Secret 正確。
• 重新登錄 Spotify 賬號。

📄 許可證

本項目遵循 MIT 協議，代碼可以自由使用和修改。