Spotify MCP Server

🚀 Spotify - MCP MCP サーバー

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

✨ 主な機能

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

🎥 デモ

音声をオンにすることを確認してください。

📦 インストール

Spotify API キーの取得

developer.spotify.com でアカウントを作成します。コンソールに移動します。 アプリを作成し、リダイレクト URI を http://localhost:8888 に設定します。（任意のポートを選択できますが、http と localhost を使用する必要があります）。 「使用する API」を「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": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
}

トラブルシューティング

この MCP を正常に動作させることができない場合は、問題を報告してください。以下はいくつかのヒントです。

1. uv が更新されていることを確認してください。バージョン >=0.54 の使用をおすすめします。
2. Claude がプロジェクトに実行権限を持っていることを確認してください：chmod -R 755。
3. Spotify のプレミアム会員であることを確認してください（開発者 API を実行するために必要です）。

この MCP は標準エラー出力にログを出力します（MCP 仕様で指定）。Mac では、Claude Desktop アプリがこれらのログを ~/Library/Logs/Claude に送信します。 他のプラットフォームでは、ここでログを見つけることができます。

以下のコマンドを使用して、npm を通じて Inspector でこの MCP を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

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

📝 今後の予定

残念ながら、Spotify API は多くのクールな機能を廃止しています。詳細は こちら を参照してください。今後の改善点は以下の通りです。

• テストの追加
• より多くの Spotify API へのサポートの追加
• コードの保守性とドキュメントの質の向上

🚀 リリースとビルド

詳細は後ほど提供されます。