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"}'