用 DXRating 開發
maimai DX 的歌曲、譜面與定數,供 AI 助理和你自己的程式使用。
MCP 伺服器
連接 Claude、ChatGPT、Cursor 或任何 MCP 用戶端。搜尋歌曲、查詢譜面、計算 Rating,無需寫程式。
伺服器 URL
https://mcp.dxrating.net/ mcpREST API
從 dxdata 開始:所有歌曲、譜面、定數、標籤和別名都在一個可快取的 JSON 文件裡。不需要帳號,也不需要 API key。
從這裡開始
https://miruku.dxrating.net/ api/ v1/ dxdata使用條款
- 資料
- 可自由使用,包括商用;歡迎註明來源。歌曲、曲繪與譜面的權利屬於 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 穩定後,v1 至少繼續運作 12 個月。
- 穩定 ID
- 歌曲 ID(dsng_…)和譜面 ID(dsht_…)永久有效,不會重複使用。遊戲裡刪除的歌曲和譜面會留在目錄裡,serverIds 變為空。如果兩個條目其實是同一首歌,保留其中一個 ID,另一個不再重複使用;拆分時保留原 ID,並新增一個 ID。兩種情況都會在更新日誌裡公告。
- 範圍
- 涵蓋無需登入的 dxdata、標籤、別名和機廳。熱門譜面和譜面圖片盡力提供。需要 DXRating 帳號的端點(留言、加標籤、提交別名、匯入成績)只供 DXRating 自己的應用程式使用,隨時可能變動。
- 接收通知
- 在 GitHub 上訂閱更新日誌 issue,每次新增欄位、端點或棄用都會收到郵件。 更新日誌
- 支援
- 問題、bug 和需求請提到 GitHub issue。 github.com/gekichumai/dxrating