remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to the Spotify Web API, enabling search for tracks, albums, artists, and playlists, as well as accessing artist information, top tracks, related artists, album information, new releases, recommendations, audiobook information, and playlist management.

アーティストレンズ

Spotify Web APIへのアクセスを提供する強力なモデルコンテキストプロトコル（MCP）サーバー。ArtistLensは、Spotifyの音楽カタログとのシームレスな連携を可能にし、トラック、アルバム、アーティストの検索に加え、トップトラックや関連アーティストといったアーティスト固有の情報へのアクセスも可能にします。

現在のバージョン: 0.4.12

インストール

Smithery経由でインストール

Smithery経由で ArtistLens for Claude Desktop を自動的にインストールするには:

npx -y @smithery/cli install @superseoworld/artistlens --client claude

手動インストール

パッケージをグローバルにインストールできます。

npm install -g @thomaswawra/artistlens

または、npx を使用して直接実行します。

npx -y @thomaswawra/artistlens

構成

MCP 設定ファイル (例: claude_desktop_config.jsonまたはcline_mcp_settings.json ) に追加します。

{
  "mcpServers": {
    "spotify": {
      "command": "npx",
      "args": ["-y", "@thomaswawra/artistlens"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Spotify API の認証情報を提供する必要があります:

Spotify開発者ダッシュボードへ
新しいアプリケーションを作成する
クライアントIDとクライアントシークレットを取得する
上記のように構成に追加します

特徴

トラック、アルバム、アーティスト、プレイリストを検索
トップトラックや関連アーティストなどのアーティスト情報を取得します
アルバム情報とトラックを取得する
新しいリリースやおすすめにアクセスする
市場固有のコンテンツと章を含むオーディオブックの情報を入手
注: オーディオブックのエンドポイントには追加の認証または市場固有のアクセスが必要になる場合があります
プレイリスト情報（名前、説明、公開/非公開ステータス）を取得および変更します
ページネーションサポートを使用してプレイリストのトラックとアイテムにアクセスします
Spotify IDとURIの両方をサポート
クライアント資格情報フローによる自動トークン管理
すべての機能に対する包括的なテストスイート
関心の分離を伴う整理されたコード

利用可能なツール

get_access_token : 有効なSpotifyアクセストークンを取得する
search : トラック、アルバム、アーティスト、またはプレイリストを検索します
get_artist : アーティスト情報を取得する
get_artist_top_tracks : アーティストのトップトラックを取得する
get_artist_related_artists : 指定したアーティストに類似したアーティストを取得する
get_artist_albums : アーティストのアルバムを取得する
get_album : アルバム情報を取得する
get_album_tracks : アルバムのトラックを取得する
get_track : トラック情報を取得する
get_available_genres : おすすめに利用可能なジャンルのリストを取得する
get_new_releases : 新しいアルバムのリリース情報を取得する
get_recommendations : シードトラック、アーティスト、またはジャンルに基づいてトラックの推奨事項を取得します
get_audiobook : オプションのマーケットパラメータを使用してオーディオブックの情報を取得します。
get_multiple_audiobooks : 複数のオーディオブックの情報を取得します（最大 50 件）
get_audiobook_chapters : ページ区切りをサポートするオーディオブックの章を取得します (リクエストごとに 1 ～ 50 章)
get_playlist : Spotifyユーザーが所有するプレイリストを取得する
get_playlist_tracks : プレイリストのトラックの詳細を取得します (リクエストごとに 1 ～ 100 トラック)
get_playlist_items : プレイリストのアイテムの詳細を取得します (リクエストごとに 1 ～ 100 個のアイテム)
modify_playlist : プレイリストの詳細（名前、説明、公開/非公開の状態、共同作業のステータス）を変更します。
add_tracks_to_playlist : 任意の位置で1つ以上のトラックをプレイリストに追加します
remove_tracks_from_playlist : 任意の位置とスナップショットIDを指定して、プレイリストから1つ以上のトラックを削除します。
get_current_user_playlists : 現在の Spotify ユーザーが所有またはフォローしているプレイリストのリストを取得します (リクエストごとに 1 ～ 50 件のプレイリスト)
get_featured_playlists : オプションのロケールとページネーションのサポートを備えた Spotify のおすすめプレイリストのリストを取得します。
get_category_playlists : 特定のカテゴリでタグ付けされた Spotify プレイリストのリストを取得します

更新中

最新バージョンに更新するには:

# If installed globally
npm update -g @thomaswawra/artistlens

# If using npx, it will automatically use the latest version
npx -y @thomaswawra/artistlens

発達

このプロジェクトはオープンソースであり、GitHub のhttps://github.com/superseoworld/artistlensで入手できます。

プロジェクト構造

コードベースは次のディレクトリに編成されています。

src/handlers/ : さまざまな Spotify API エンドポイントのハンドラークラスが含まれています
src/types/ : リクエストおよびレスポンスオブジェクトのTypeScriptインターフェース
src/utils/ : API通信用のユーティリティ関数とクラス
src/__tests__/ : すべての機能のJestテストファイル

テスト

このプロジェクトではテストにJestを使用しています。テストを実行するには、以下の手順に従ってください。

npm test

開発中にウォッチモードでテストを実行するには:

npm run test:watch

貢献

貢献するには:

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更に対するテストを追加する
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

MITライセンス

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Spotify Web API を介して Spotify の音楽カタログとのやり取りを可能にし、検索、アーティスト情報の取得、プレイリストの管理、自動トークン処理をサポートします。

Related Resources

Reddit Discussion about this server

MCP Spotify Server