musicport

musicport

Spotify Web API と連携する、Spotify の検索、再生、プレイリスト用 MCP ツールです。musicport は、コミュニティの Spotify MCP サーバーの主要機能を、新しい名前でクリーンルーム方式により再構築したものです。コードは新規に作成されており、ブランド表記もコピーしていません。

トークン環境変数のみ。 ホスト型／コミュニティ型の OAuth フロー（SPOTIFY_CLIENT_ID / SPOTIFY_CLIENT_SECRET ＋ ブラウザーでの同意 ＋ 更新）は再現していません。ツールは SPOTIFY_ACCESS_TOKEN を Authorization: Bearer として直接使用します。

ツール（主要なサブセット、12 個）

search、get_current_user_profile、get_playback_state、play、 pause、next_track、previous_track、list_playlists、 get_playlist、create_playlist、add_tracks_to_playlist、 list_saved_tracks。

このサブセットに含まれない機能：OAuth の認証／更新フロー、検索以外でのトラック／アルバム／アーティスト詳細の取得、オーディオ特徴量／分析、おすすめ、番組／エピソード／オーディオブック、アーティストやユーザーのフォロー／フォロー解除、プレイリストのカバー画像、プレイリスト項目の削除／並べ替えの詳細機能、ライブラリ内のアルバム／番組、デバイス一覧表示と再生の転送、キュー管理、最近再生した項目、トップ項目。

セットアップ

Spotify アクセストークンを独自の方法で取得し、設定します。

export SPOTIFY_ACCESS_TOKEN=BQ...

必要に応じて、SPOTIFY_API_BASE_URL で API ベース URL を上書きできます（デフォルトは https://api.spotify.com/v1）。トークンが設定されていない場合、すべてのツール呼び出しは、不足している変数名を示すエラーで失敗します。 SPOTIFY_ACCESS_TOKEN environment variable is required

CLI

npx @reneturcios/musicport search '{"query":"hello"}'
npx @reneturcios/musicport mcp        # stdio MCP server

各ツール名はサブコマンドで、引数として 1 つの JSON オブジェクトを受け取ります。

MCP クライアント設定

{
  "mcpServers": {
    "musicport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/musicport", "mcp"],
      "env": { "SPOTIFY_ACCESS_TOKEN": "BQ..." }
    }
  }
}

Docker

docker run -i -e SPOTIFY_ACCESS_TOKEN ghcr.io/cloudcorprecords/musicport

開発

npm install
npm run build
npm test

ライセンス

MIT