Spotify MCP

🚀 Spotify-MCP サーバープロジェクト

このプロジェクトは、ClaudeとSpotifyを接続することを目的としています。spotipy-devのAPIをベースに構築されています。

✨ 主な機能

• 再生制御：再生の開始、一時停止、およびスキップ
• 曲、アルバム、アーティスト、またはプレイリストの検索
• 曲、アルバム、アーティスト、またはプレイリストに関する情報の取得
• Spotifyキューの管理

🎥 デモ

音声をオンにしてください。

📚 設定説明

Spotify APIキーの取得

developer.spotify.comでアカウントを作成します。ダッシュボードに移動し、アプリを作成します。redirect_uriをhttp://localhost:8888に設定します（任意のポートを選択できますが、httpとlocalhostを使用する必要があります）。「APIs used」を「Web Playback SDK」に設定します。

このプロジェクトをローカルで実行する

このプロジェクトは、環境なしでの実行には設定されていません（例：uvxの使用）。このリポジトリをクローンして、ローカルで実行します。

git clone https://github.com/varunneal/spotify-mcp.git

このツールをMCPサーバーとして追加します。

• MacOSの場合：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windowsの場合：%APPDATA%/Claude/claude_desktop_config.json

"spotify": {
    "command": "uv",
    "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
    ],
    "env": {
        "SPOTIFY_CLIENT_ID": あなたの_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": あなたの_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
}

トラブルシューティング

このMCPが使用できない場合は、問題を開いてください。以下はいくつかのヒントです。

1. uvが更新されていることを確認してください。推奨バージョンは>=0.54です。
2. Claudeに実行権限があることを確認してください：chmod -R 755。
3. Spotify Premiumを持っていることを確認してください（開発者APIを実行するために必要です）。

このMCPは、標準エラーストリームに出力されます（MCP仕様で指定されているとおり）。Macでは、Claude Desktopアプリケーションはこのパスでログを表示します：~/Library/Logs/Claude。他のプラットフォームでは、ここでログを見つけることができます。

📋 今後の予定

残念ながら、Spotify APIの一部の機能が停止されたため、多くのクールな機能が実装できなくなっています。主にプロジェクトの健全性向上に注力します。

• テストの追加
• プレイリスト管理のためのAPIサポートの追加
• 検索結果、プレイリスト/アルバムなどのページングのためのAPIサポートの追加

プルリクエストは大歓迎です！

🚀 デプロイ

（未定）

パッケージングと公開

リリースバージョンを準備します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. リリースバージョンをビルドします。

uv build

これにより、dist/ディレクトリにソースコードとホイール形式の配布物が作成されます。 3. PyPIに公開します。

uv publish

注意：PyPIの資格情報を環境変数またはコマンドライン引数で設定する必要があります。

• トークン：--tokenまたはUV_PUBLISH_TOKEN
• またはユーザー名/パスワード：--username/UV_PUBLISH_USERNAMEおよび--password/UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーは標準入出力で動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspectorの使用を強くおすすめします。

以下のコマンドでMCP Inspectorを起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

起動後、InspectorはURLを表示します。このURLをブラウザで開いてデバッグを開始できます。