Spotify MCP Server

Spotify MCP サーバー

Spotify MCP サーバーは、Spotify API と連携するために設計された Model Context Protocol（MCP）サーバーです。Spotify の再生を制御するツールを提供しており、再生、一時停止、曲のスキップ、プレイリストのシャッフルなどを実行できます。このサーバーは、mcp フレームワークと spotipy ライブラリを使用して構築されています。

機能

• 曲の再生、一時停止、スキップができます。
• プレイリストをシャッフルしたり、リピートしたりできます。
• 名前を指定してアルバムや曲を再生できます。
• Spotify の再生をシームレスに制御するための組み込みツールを備えています。

前提条件

サーバーをセットアップする前に、以下が揃っていることを確認してください。

1. Python 3.12 以降。
2. アプリケーションを登録済みの Spotify Developer アカウント。以下が必要です。
   • SPOTIFY_CLIENT_ID
   • SPOTIFY_CLIENT_SECRET
3. Spotify の認証情報を含む .env ファイル。
4. Spotify Premium アカウント

インストール

1. リポジトリをクローンします。

   git clone <repository-url>
   cd spotify-mcp-server
   

2. 仮想環境を作成して有効化します。

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 依存関係を管理するために uv をインストールします。

   pip install uv
   

   Windows

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

4. pyproject.toml ファイルを使って uv で依存関係をインストールします。

   uv sync
   

5. プロジェクトのルートに .env ファイルを作成し、Spotify の認証情報を追加します。

   SPOTIFY_CLIENT_ID=your_client_id
   SPOTIFY_CLIENT_SECRET=your_client_secret
   

使い方

1. MCP サーバーを起動します。

   python server.py
   

2. 提供されているツールを使って Spotify の再生を制御します。例：

   • play()：現在の曲の再生を開始します。
   • pause()：現在の曲を一時停止します。
   • next_track()：次の曲にスキップします。
   • play_album("album_name")：名前を指定して特定のアルバムを再生します。
   • play_track("track_name")：名前を指定して特定の曲を再生します。

3. MCP ツールを MCP クライアントに追加します。たとえば、Claude を使用している場合： プロジェクトのルートに以下を追加します

   uv mcp install server.py
   

Example Using Calude Desktop

Here is the JSON file

{
"mcpServers": {
  "spotify-mcp-server": {
    "command": "~path-to-project\\spotify-mcp-server\\.venv\\Scripts\\python.exe",
    "args": [
      "~path-to-project\\spotify-mcp-server\\server.py"
    ],
    "transport": "stdio",
    "env":{
      "SPOTIFY_CLIENT_ID": "############",
      "SPOTIFY_CLIENT_SECRET": "############",
      "TRANSPORT": "stdio"
    }
  }
}
}

Troubleshooting

• Spotify Authentication Failed: Ensure your SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are correctly set in the .env file.

• Server Not Starting: Verify that the __name__ check in server.py is correctly set to __server__:

   if __name__ == "__server__":
    mcp.run()
  

コントリビューション

コントリビューションを歓迎します！お気軽に issue を作成するか、プルリクエストを送信してください。