MCP Claude Spotify

🚀 MCP Claude Spotify プロジェクトガイド

このプロジェクトは、SpotifyをMCPシステムに統合し、音楽制御機能を提供します。以下の手順に従って、簡単にセットアップして使用できます。

🚀 クイックスタート

このセクションでは、MCP Claude Spotify プロジェクトをすばやくセットアップして使用するための基本的な手順を説明します。

📦 インストール

リポジトリのクローン

Gitを使用してこのリポジトリをクローンします。

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

依存関係のインストール

リポジトリのディレクトリに移動した後、プロジェクトに必要な依存関係をインストールします。

npm install

📚 ドキュメント

アプリケーションの作成

1. Spotify Developer Dashboardにアクセスします。
2. "Create Application"をクリックします。
3. アプリケーションの情報を入力します。
   • Application Name: MCP Claude Spotify などの名前を入力します。
   • Description: 適切な説明を追加します。
   • Redirect URI: http://localhost:3000/callback などのリダイレクトURIを少なくとも1つ追加します（開発環境のみ）。
4. 作成が完了したら、Client IDとClient Secretをメモしておきます。

プロジェクトの設定

リポジトリのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

SPOTIFY_CLIENT_ID=your_client_id_here
SPOTIFY_CLIENT_SECRET=your_client_secret_here

💻 使用例

Spotifyの認証

Claude Desktopで以下のコマンドを入力して、Spotifyアカウントを認証します。

mcp spotify auth

指示に従って認証プロセスを完了します。完了すると、~/.spotify-mcp ディレクトリに tokens.json ファイルが生成され、アクセストークンとリフレッシュトークンが保存されます。

ツールの使用

以下は、利用可能なMCPツールとそのコマンドです。

🔧 技術詳細

ファイル構造

.
├── src/
│   ├── cli.js          # MCPツールのメインエントリポイント
│   ├── commands/
│   │   ├── auth.js     # 認証コマンドの処理ロジック
│   │   └── player.js   # プレーヤー制御コマンドの処理ロジック
│   └── config.js       # プロジェクトの設定ファイル
├── package.json        # プロジェクトの依存関係とスクリプト
└── .env                # 環境変数の設定ファイル

貢献ガイド

開発フロー

1. リポジトリのクローン

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

2. 依存関係のインストール

npm install

3. 開発環境 以下のコマンドを使用して開発サーバーを起動します。

npm run dev

4. テスト プロジェクトのルートディレクトリで以下のコマンドを実行します。

npm test

コードスタイル

• Node.js コード規約に従います。
• 明確なコメントとドキュメントを提供します。
• コードの一貫性と可読性を確保します。

プロジェクト構造

以下のファイル構造を維持します。

.
├── src/
│   ├── commands/       # MCPコマンドの処理ロジックを格納
│   └── config.js      # プロジェクトの設定ファイル
└── package.json        # プロジェクトの依存関係とスクリプト

コミットガイド

以下のコマンドを使用してコードをコミットします。

git add .
git commit -m "你的提交信息"
git push origin main

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細については、LICENSE ファイルを参照してください。

以上の手順に従えば、SpotifyをMCPシステムに簡単に統合し、音楽制御機能を楽しむことができます。さらなる支援が必要な場合は、プロジェクトのドキュメントを参照するか、メンテナンスチームにお問い合わせください。