mcpField
B
Beatport MCP Server

Beatport MCP Server

ローカル
github.com/ivo-tobyゲーム・エンタメ474 週間前に更新
リポジトリ

Beatport MCP Server について

開発中の MCP サーバーで、LLM クライアントを Beatport に接続し、音楽の検索やカタログデータの取得を行います。Beatport の OpenAPI 仕様からツールを生成し、stdio と HTTP に対応します。

主な機能

  1. 01トラックとアーティストの検索
  2. 02リリースとレーベル情報の取得
  3. 03チャートとプレイリストの閲覧
  4. 04ジャンル、BPM、キーでの絞り込み
  5. 05stdio と HTTP のトランスポート

活用シーン

  1. 01ジャンルとリリース日でトラックを検索
  2. 02レーベルのリリース作品を調査
  3. 03チャート項目とプレイリストを閲覧

MCP 対応

Beatport API エンドポイントから、カタログ検索、メタデータ取得、チャート、プレイリスト用の MCP ツールを生成します。stdio と HTTP に対応します。

#beatport#mcp-server#music-discovery

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

インストール方法は未掲載です

このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。

リポジトリ

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Beatport MCP Server

ご注意ください。これはまだ開発中です！！

音楽の発見やデータ取得のために、Beatport API へのアクセスを提供する MCP（Model Context Protocol）サーバーです。

特長

  • 簡単な認証：ユーザー名とパスワードによるシンプルな認証
  • Beatport API 全般：トラック、アーティスト、レーベル、リリース、チャートなどにアクセスできます
  • 柔軟なトランスポート：stdio と HTTP の両方のトランスポートに対応
  • OpenAPI ベース：公式の Beatport OpenAPI 仕様を活用

インストール

npm install -g @ivotoby/beatport-mcp-server

認証

⚠️ 重要：Beatport API には、一般公開されていない OAuth2 認証情報が必要です。以下の 3 つの方法があります。

方法 1：手動でトークンを設定（推奨）
  1. トークンを取得します：
node get-token.js  # Shows detailed instructions
  1. トークンを設定します：
export BEATPORT_ACCESS_TOKEN="your_token_here"
beatport-mcp-server
方法 2：ユーザー名とパスワード（現在は動作しません）
export BEATPORT_USERNAME="[email protected]"
export BEATPORT_PASSWORD="yourpassword"
beatport-mcp-server
方法 3：Beatport に問い合わせる

[email protected] にメールを送り、「Beatport MCP Server」用の OAuth2 認証情報をリクエストしてください。

HTTP トランスポート
beatport-mcp-server --transport http --port 3000

設定オプション

  • --username, -u：Beatport のユーザー名／メールアドレス（または BEATPORT_USERNAME）
  • --password, -p：Beatport のパスワード（または BEATPORT_PASSWORD）
  • --transport, -t：トランスポートの種類：stdio（デフォルト）または http
  • --accessToken, -a：ベアラートークン（または BEATPORT_ACCESS_TOKEN）
  • --refreshToken, -r：リフレッシュトークン（または BEATPORT_REFRESH_TOKEN）
  • --port：HTTP ポート（デフォルト：3000、HTTP トランスポート用）
  • --host：HTTP ホスト（デフォルト：127.0.0.1、HTTP トランスポート用）
  • --path：HTTP エンドポイントのパス（デフォルト：/mcp、HTTP トランスポート用）
  • --name, -n：サーバー名（デフォルト：beatport-mcp-server）
  • --version, -v：サーバーのバージョン（デフォルト：1.0.0）
  • --tools：ツールモード：all（デフォルト）または dynamic
  • --tool：指定したツール ID または名前のツールのみをインポート
  • --tag：指定した OpenAPI タグが付いたツールのみをインポート
  • --resource：指定したリソースパスのプレフィックス配下にあるツールのみをインポート
  • --operation：指定した HTTP メソッドのツールのみをインポート
  • --disable-abbreviation：ツール名の最適化を無効化

利用可能なツール

このサーバーは Beatport API のエンドポイントから MCP ツールを自動生成します。

カタログ
  • catalog-artists-list：アーティストを検索して一覧表示
  • catalog-artists-retrieve：アーティストの詳細を取得
  • catalog-tracks-list：トラックを検索して一覧表示
  • catalog-releases-list：リリースを検索して一覧表示
  • catalog-labels-list：レーベルを検索して一覧表示
  • catalog-genres-list：音楽ジャンルを一覧表示
チャートとプレイリスト
  • catalog-charts-list：チャートを閲覧
  • catalog-playlists-list：プレイリストを閲覧
検索と発見
  • ジャンル、レーベル、アーティスト、BPM、キー、リリース日による絞り込み
  • ページネーションに対応
  • トラックとリリースの詳細なメタデータ

Claude での使用例

Claude Desktop に接続すると、次のようなコマンドを使用できます。

Search for tech house tracks released in 2024
Find all releases on Drumcode label
Get details for artist "Charlotte de Witte"
List top 10 tracks in the Techno chart
Find tracks with BPM between 120-130

認証に関する注意事項

  • Beatport の OAuth2 リソースオーナーパスワード認証情報フローを使用します
  • 有効な Beatport アカウントが必要です
  • トークンは自動的に管理および更新されます
  • Beatport のクライアント認証情報を扱う必要はありません（内部で処理されます）

開発

git clone https://github.com/ivo-toby/beatport-mcp-server
cd beatport-mcp-server
npm install
npm run build
npm run start

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

コントリビューション

イシューやプルリクエストを歓迎します！このプロジェクトは @ivotoby/openapi-mcp-server パッケージを基盤としています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。