DXRating で開発する

maimai DX の楽曲・譜面・譜面定数を、AI アシスタントや自作ツールから。

MCP サーバー

Claude、ChatGPT、Cursor などの MCP クライアントに接続。楽曲検索、譜面情報、レート計算をコードなしで。

サーバー URL

https://mcp.dxrating.net/mcp

MCP を設定

REST API

まずは dxdata から。全楽曲・譜面・譜面定数・タグ・別名をキャッシュ可能な 1 つの JSON で取得できます。アカウントも API キーも不要です。

まずはここから

https://miruku.dxrating.net/api/v1/dxdata

API ドキュメント OpenAPI 変更履歴 llms.txt

利用条件

データ: 商用を含めて自由に使えます。クレジット表記があると嬉しいです。楽曲・ジャケット・譜面の権利は SEGA および各権利者に帰属し、DXRating は著作権を主張しません。
クレジット表記: Data from DXRating (dxrating.net)
レート制限: MCP：クライアントごとに毎分約 300 リクエスト。REST API：上限は設けていませんが、レスポンスはキャッシュし、If-None-Match で再検証してください。dxdata・タグ・別名・店舗は ETag を返します。

API の安定性

API v1 は安定版です。ツール・bot・サイトを作るときに当てにできることをまとめました。

互換性: v1 の中での変更は追加のみです：新しいエンドポイント、任意パラメーター、レスポンスのフィールド、列挙値。知らないフィールドや値は無視してください。削除・名前の変更・型や意味の変更は破壊的変更として扱います。データの修正（譜面定数、曲名、日付、収録サーバー）は破壊的変更ではありません。
非推奨化: 廃止するものは少なくとも 6 か月前に告知します。変更履歴で知らせ、廃止までレスポンスに Deprecation（RFC 9745）と Sunset（RFC 8594）ヘッダーを付けます。
新バージョン: 破壊的変更は /api/v2 の新バージョンで行います。v2 が安定版になってから少なくとも 12 か月は v1 も動き続けます。
固定 ID: 楽曲 ID（dsng_…）と譜面 ID（dsht_…）は恒久的で、再利用しません。ゲームから削除された楽曲・譜面もカタログに残り、serverIds が空になります。2 つの項目が同じ曲だと分かった場合は片方の ID を残し、もう一方は再利用しません。分割する場合は元の ID を残し、新しい ID を追加します。どちらも変更履歴で告知します。
対象: 対象はログイン不要の dxdata・タグ・別名・店舗です。トレンドと譜面画像はベストエフォートです。DXRating アカウントが必要なもの（コメント、タグ付け、別名の投稿、スコアのインポート）は DXRating 自身のアプリ向けで、いつでも変わることがあります。
通知を受け取る: GitHub の変更履歴 issue を Subscribe すると、新しいフィールド・エンドポイント・非推奨化のたびにメールが届きます。変更履歴
サポート: 質問・不具合・要望は GitHub の issue へどうぞ。 github.com/gekichumai/dxrating