アーティストレンズ

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

現在のバージョン: 0.4.12

インストール

Smithery経由でインストール

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

手動インストール

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

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

Related MCP server: Spotify-Claude MCP Server

構成

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

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

1. Spotify開発者ダッシュボードへ

2. 新しいアプリケーションを作成する

3. クライアントIDとクライアントシークレットを取得する

4. 上記のように構成に追加します

特徴

• トラック、アルバム、アーティスト、プレイリストを検索

• トップトラックや関連アーティストなどのアーティスト情報を取得します

• アルバム情報とトラックを取得する

• 新しいリリースやおすすめにアクセスする

• 市場固有のコンテンツと章を含むオーディオブックの情報を入手

• 注: オーディオブックのエンドポイントには追加の認証または市場固有のアクセスが必要になる場合があります

• プレイリスト情報（名前、説明、公開/非公開ステータス）を取得および変更します

• ページネーションサポートを使用してプレイリストのトラックとアイテムにアクセスします

• 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 プレイリストのリストを取得します

更新中

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

発達

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

プロジェクト構造

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

• src/handlers/ : さまざまな Spotify API エンドポイントのハンドラークラスが含まれています

• src/types/ : リクエストおよびレスポンスオブジェクトのTypeScriptインターフェース

• src/utils/ : API通信用のユーティリティ関数とクラス

• src/__tests__/ : すべての機能のJestテストファイル

テスト

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

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

貢献

貢献するには:

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更に対するテストを追加する

4. 変更をコミットします ( git commit -m 'Add some amazing feature' )

5. ブランチにプッシュする ( git push origin feature/amazing-feature )

6. プルリクエストを開く

ライセンス

MITライセンス