DXRating으로 개발하기

maimai DX 곡, 채보, 보면 상수를 AI 어시스턴트와 직접 만든 코드에서.

MCP 서버

Claude, ChatGPT, Cursor 등 MCP 클라이언트에 연결하세요. 곡 검색, 채보 조회, 레이팅 계산을 코드 없이.

서버 URL

https://mcp.dxrating.net/mcp

MCP 설정

REST API

dxdata부터 시작하세요. 모든 곡, 채보, 보면 상수, 태그, 별명을 캐시 가능한 JSON 문서 하나로 받을 수 있습니다. 계정이나 API 키는 필요 없습니다.

여기서 시작

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

API 문서 OpenAPI 변경 기록 llms.txt

이용 조건

출처 표기: Data from DXRating (dxrating.net)
요청 제한: MCP: 클라이언트당 분당 약 300회. REST API: 고정 한도는 없지만 응답을 캐시하고 If-None-Match로 재검증해 주세요. dxdata, 태그, 별명, 오락실 목록은 ETag를 보냅니다.

API 안정성

API v1은 안정 버전입니다. 도구, 봇, 사이트를 만들 때 믿고 쓸 수 있는 내용입니다.

호환성: v1 안에서는 추가만 합니다: 새 엔드포인트, 선택 파라미터, 응답 필드, 열거값. 모르는 필드와 값은 무시하세요. 삭제, 이름 변경, 타입이나 의미 변경은 호환성을 깨는 변경으로 봅니다. 데이터 수정(보면 상수, 곡명, 날짜, 수록 서버)은 해당하지 않습니다.
지원 중단: 없애는 기능은 최소 6개월 전에 알립니다. 변경 기록에 공지하고, 없어질 때까지 응답에 Deprecation(RFC 9745)과 Sunset(RFC 8594) 헤더를 붙입니다.
새 버전: 호환성을 깨는 변경은 /api/v2 새 버전에서 합니다. v2가 안정된 뒤에도 최소 12개월 동안 v1은 계속 동작합니다.
고정 ID: 곡 ID(dsng_…)와 채보 ID(dsht_…)는 영구적이며 재사용하지 않습니다. 게임에서 삭제된 곡과 채보도 카탈로그에 남고 serverIds가 비게 됩니다. 두 항목이 같은 곡으로 밝혀지면 한쪽 ID를 유지하고 다른 ID는 재사용하지 않습니다. 나눌 때는 원래 ID를 유지하고 새 ID를 추가합니다. 둘 다 변경 기록에 공지합니다.
범위: 적용 대상은 로그인이 필요 없는 dxdata, 태그, 별명, 오락실입니다. 인기 차트와 채보 이미지는 최선을 다해 제공합니다. DXRating 계정이 필요한 엔드포인트(댓글, 태그 달기, 별명 제출, 점수 가져오기)는 DXRating 자체 앱용이며 언제든 바뀔 수 있습니다.
알림 받기: GitHub의 변경 기록 이슈를 구독하면 새 필드, 엔드포인트, 지원 중단마다 이메일을 받습니다. 변경 기록
지원: 질문, 버그, 요청은 GitHub 이슈로 보내 주세요. github.com/gekichumai/dxrating