MCP Spotify Server

🚀 アーティストレンズ（ArtistLens）

強力なモデルコンテキストプロトコル（MCP）サーバーで、Spotify Web API へのアクセスを提供します。ArtistLens を使うと、Spotify の音楽ディレクトリとシームレスにやり取りできます。曲、アルバム、アーティストの検索や、特定のアーティストの詳細情報（人気曲や関連アーティストなど）の取得が可能です。

現在のバージョン: 0.4.12

🚀 クイックスタート

ArtistLens は、強力なモデルコンテキストプロトコル（MCP）サーバーで、Spotify Web API へのアクセスを提供します。これを使うことで、Spotify の音楽ディレクトリとシームレスにやり取りできます。

✨ 主な機能

• Spotify の音楽ディレクトリとのシームレスなやり取りを可能にします。
• 曲、アルバム、アーティストの検索ができます。
• 特定のアーティストの詳細情報（人気曲や関連アーティストなど）を取得できます。

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Claude 用に ArtistLens を自動インストールします。

npx smithery install @superseoworld/artistlens

手動インストール

npm または yarn を使用してグローバルにインストールします。

npm install -g @thomaswawra/artistlens
# または
yarn global add @thomaswawra/artistlens

📚 ドキュメント

設定

~/.config ディレクトリに smithery.json ファイルを作成または編集し、以下の内容を追加します。

{
  "artistlens": {
    "version": "0.4.12"
  }
}

node_modules または yarn ディレクトリが PATH 環境変数に含まれていることを確認してください。

更新

最新バージョンに更新するには、以下のコマンドを使用します。

# グローバルにインストールされている場合
npm update -g @thomaswawra/artistlens

# npx を使用している場合、自動的に最新バージョンが使用されます
npx -y @thomaswawra/artistlens

使用方法

ターミナルで artistlens と入力してサーバーを起動します。デフォルトでは、ローカルホストの 3001 ポートで実行されます。

開発

このプロジェクトはオープンソースで、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

コントリビューション

コードを貢献するには、以下の手順に従ってください。

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 License