アーティストレンズ
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/artistlensRelated MCP server: Spotify-Claude MCP Server
構成
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 の認証情報を提供する必要があります:
新しいアプリケーションを作成する
クライアント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ライセンス