DXRatingMCP
Markdown

DXRating MCP 服务器

让 AI 助手懂 maimai DX。连上这个服务器后，Claude、ChatGPT、Cursor、VS Code、Cherry Studio 等 AI 应用就能用曲名或别名查 DXRating（dxrating.net）的歌曲和谱面，查日服、国际服、美服和国服的定数（譜面定数），并计算 Rating 和 B50。

MCP（Model Context Protocol）是 AI 应用连接外部工具的标准方式。

服务器 URL

https://mcp.dxrating.net/mcp
传输方式
Streamable HTTP（不是 SSE）
认证
无。应用问的话选「无需认证」或「No authentication」。
建议名称
dxrating

URL 要和上面完全一致，以 /mcp 结尾。本页（https://mcp.dxrating.net/）是说明页，不是服务器本身。

一键添加

添加到 Claude添加到 Cursor添加到 VS Code添加到 Cherry Studio

会打开应用并填好服务器，你确认后才会添加。

让你的 Agent 来装

把下面这段粘贴给 Claude Code、Codex、Cursor 等编程 Agent：

Add the DXRating MCP server to this agent: URL https://mcp.dxrating.net/mcp, transport Streamable HTTP, no authentication. Follow the steps for this client in https://mcp.dxrating.net/llms.txt, add it at user (global) scope, then list its tools to confirm it works.

添加

Claude claude.ai, Claude Desktop, Claude mobile

  1. 打开 添加到 Claude，或进入 Customize → Connectors → + Add → Add custom connector。
  2. 名称：DXRating。Remote MCP server URL：https://mcp.dxrating.net/mcp。点 Continue。
  3. Authentication 选 No sign in，再点 Add。
  4. 在对话里点 + → Connectors，打开 DXRating。

免费版只能加一个自定义连接器。Team 和 Enterprise 版由管理员在 Organization settings → Connectors 添加，成员再点 Connect。手机 App 不能添加连接器，在网页或桌面端添加后会同步过去。

文档 support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

ChatGPT web

  1. 打开 https://chatgpt.com/plugins，点 +，再点 Add custom MCP server。
  2. 名称 DXRating，Server URL https://mcp.dxrating.net/mcp。
  3. Authentication 选 No authentication。看完提示后点 I understand and want to continue，再点 Create as a plugin。
  4. 安装插件。在对话里输入 @ 并选择 DXRating。

能否使用取决于你的套餐和工作区设置。

文档 developers.openai.com/api/docs/guides/custom-mcp-server

Cherry Studio

一键添加：添加到 Cherry Studio。添加后服务器默认是关闭的，确认后再打开。手动添加：设置 → MCP → MCP 服务器 → 添加 → 从 JSON 导入，粘贴：

JSON
{  "mcpServers": {    "dxrating": {      "type": "streamableHttp",      "url": "https://mcp.dxrating.net/mcp"    }  }}

保留 "type": "streamableHttp"。少了它 Cherry Studio 会用旧的 SSE 连接，然后失败。

文档 docs.cherryai.com.cn/advanced-basic/extensions/mcp

Claude Code

Terminal
claude mcp add --transport http --scope user dxrating https://mcp.dxrating.net/mcp

用 claude mcp list 或 /mcp 检查。项目里的 .mcp.json 要写上 "type": "http"：

.mcp.json
{  "mcpServers": {    "dxrating": {      "type": "http",      "url": "https://mcp.dxrating.net/mcp"    }  }}

文档 code.claude.com/docs/en/mcp

Cursor

添加到 Cursor，或写进 ~/.cursor/mcp.json：

~/.cursor/mcp.json
{  "mcpServers": {    "dxrating": {      "url": "https://mcp.dxrating.net/mcp"    }  }}

文档 cursor.com/docs/mcp

VS Code GitHub Copilot

添加到 VS Code，或运行：

Terminal
code --add-mcp '{"name":"dxrating","type":"http","url":"https://mcp.dxrating.net/mcp"}'

.vscode/mcp.json 和用户配置里的 mcp.json 顶层键是 servers，不是 mcpServers：

.vscode/mcp.json
{  "servers": {    "dxrating": {      "type": "http",      "url": "https://mcp.dxrating.net/mcp"    }  }}

文档 code.visualstudio.com/docs/agent-customization/mcp-servers

Codex CLI, IDE extension, ChatGPT desktop app

Terminal
codex mcp add dxrating --url https://mcp.dxrating.net/mcp

或写进 ~/.codex/config.toml（IDE 插件和 ChatGPT 桌面版共用这个文件）：

~/.codex/config.toml
[mcp_servers.dxrating]url = "https://mcp.dxrating.net/mcp"

文档 learn.chatgpt.com/docs/extend/mcp

Gemini CLI

Terminal
gemini mcp add --transport http -s user dxrating https://mcp.dxrating.net/mcp

或在 ~/.gemini/settings.json 里用 httpUrl（在 Gemini 里 url 表示旧的 SSE）：

~/.gemini/settings.json
{  "mcpServers": {    "dxrating": {      "httpUrl": "https://mcp.dxrating.net/mcp"    }  }}

文档 geminicli.com/docs/tools/mcp-server/

其他应用

用这个 URL 添加远程 MCP 服务器，选 Streamable HTTP、无需认证。大多数应用（Trae、Kiro、LM Studio、Windsurf、JetBrains AI Assistant）都接受这段 JSON：

JSON
{  "mcpServers": {    "dxrating": {      "url": "https://mcp.dxrating.net/mcp"    }  }}

只支持本地（stdio）服务器的应用可以通过 mcp-remote 连接（需要 Node.js）：

JSON
{  "mcpServers": {    "dxrating": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mcp.dxrating.net/mcp",        "--transport",        "http-only"      ]    }  }}

试试看

用中文、日本語、English 问都可以。曲名、别名、外号都能搜到。

  • 「潘」是哪首歌？列出它各难度的等级。

  • PANDORA PARADOXXX 的白谱定数在日服、国际服和国服分别是多少？

  • 国际服 14 级里定数最低的谱面有哪些？

  • 系ぎて 紫谱 100.5% 是多少 Rating？想拿 300 要打多少？

  • 这是我的最好成绩：…… 我的 Rating 是多少，先推哪些谱面？

  • PANDORA PARADOXXX 紫谱的定数在各版本有没有变过？

确认能用： 问「用 DXRating 查一下 系ぎて 紫谱的定数」。好的回答会说明是哪个服务器和版本，并注明数据来自 DXRating。如果助手没调用工具就回答了，跟它说「用 DXRating 的工具」。

工具

所有工具都是只读的。只读取公开的歌曲数据，看不到也改不了任何账号。

  • search_songs

    按曲名、别名、外号、罗马字或曲师搜歌，附带每张谱面的等级

  • get_sheet

    歌曲和谱面详情：当前和历代版本的定数、物量、谱师、所在服务器、标签

  • calculate_rating

    某谱面某达成率的 Rating、达到目标 Rating 所需的达成率、各评级的 Rating

  • calculate_best50

    根据贴上的成绩算 Rating：新曲 B15 和旧曲 B35，以及值得推的谱面

数据和许可

  • 歌曲、谱面、别名和标签来自 DXRating（dxrating.net），随游戏更新而更新。定数可能因服务器而不同：jp（日服）、intl（国际服）、usa（美服）和 cn（国服）。助手会问你玩哪个服，否则用 jp。
  • 工具收发的达成率是以 1/10000 % 为单位的整数：100.7543% 就是 1007543。助手会帮你换算。
  • Rating 按游戏规则算：B50 是当前版本最好的 15 张谱面加上旧版本最好的 35 张。AP 和 AP+ 每张谱面加 1。
  • 许可：CC BY-NC 4.0，可非商业使用，需注明 Data: DXRating (https://dxrating.net), CC BY-NC 4.0。服务器会提醒助手附上这一行。

限制

  • 每个 IP 地址每分钟 300 次请求。一个问题通常需要 1 到 4 次请求。
  • 超过限制时服务器会回复「Too many requests. Retry in N seconds.」，等这么多秒后再试。
  • Claude.ai 和 ChatGPT 从各自公司的服务器连接，所以它们的用户可能共用一个限额。
  • B50 每次最多算 300 条成绩。

隐私

  • 没有账号、没有 Key、没有 Cookie。本页不加载任何第三方脚本，也没有统计分析。
  • 服务器只收到助手发来的内容：工具名和参数，比如曲名或你贴的成绩。它看不到你的对话，也不会保存你的成绩。
  • 每个请求会记录时间、路径、状态码、耗时和请求头（包括 IP 地址和 User-Agent），但不记录包含工具参数的请求体。日志发送到我们的监控服务（Sentry），只用于运维和防止滥用。
  • 请求会经过 Cloudflare，由 Cloudflare 按其条款处理。

常见问题

连不上、SSE 报错或 405
应用可能在用旧的 SSE 传输方式，本服务器不支持。请选 Streamable HTTP：Cherry Studio 里写 "type": "streamableHttp"，Gemini CLI 里用 httpUrl。
应用要求登录
不需要登录。选「No sign in」或「No authentication」。
在浏览器打开 /mcp 跳到了这里
这是正常的。这个地址只接受 AI 应用的 POST 请求。
提示「still loading its song catalog」
服务器刚重启，过一分钟再试。
添加了但助手不用
在对话里打开连接器，并说「用 DXRating」。

不用 AI 测试： 运行 npx @modelcontextprotocol/inspector，选 Streamable HTTP 并填入 URL。或者：

Terminal
curl -s https://mcp.dxrating.net/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -H 'Mcp-Protocol-Version: 2025-06-18' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'