用 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