# DXRating MCP 伺服器 讓 AI 助理懂 maimai DX。連上這個伺服器後，Claude、ChatGPT、Cursor、VS Code、Cherry Studio 等 AI 應用程式就能用曲名或別名查詢 DXRating（dxrating.net）的歌曲和譜面，查日版、國際版、美版和國服的定數（譜面定数），並計算 Rating 和 B50。 MCP（Model Context Protocol）是 AI 應用程式連接外部工具的標準方式。 **免費 · 不需帳號 · 不需 API Key · 唯讀** ## 讓你的 Agent 來設定 把下面這段貼給 Claude Code、Codex、Cursor 等程式 Agent： ```text 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. ``` ## 加入 | | | |---|---| | 伺服器 URL | `https://mcp.dxrating.net/mcp` | | 傳輸方式 | Streamable HTTP（不是 SSE） | | 驗證 | 無。應用程式詢問時選「不需驗證」或「No authentication」。 | | 建議名稱 | `dxrating` | URL 請和上面完全相同，以 `/mcp` 結尾。本頁（https://mcp.dxrating.net/）是說明頁，不是伺服器本身。 **一鍵加入：** [加入 Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=DXRating&connectorUrl=https%3A%2F%2Fmcp.dxrating.net%2Fmcp) · [加入 Cursor](https://cursor.com/en/install-mcp?name=dxrating&config=eyJ1cmwiOiJodHRwczovL21jcC5keHJhdGluZy5uZXQvbWNwIn0%3D) · [加入 VS Code](https://vscode.dev/redirect/mcp/install?name=dxrating&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.dxrating.net%2Fmcp%22%7D) · [加入 Cherry Studio](cherrystudio://mcp/install?servers=eyJtY3BTZXJ2ZXJzIjp7ImR4cmF0aW5nIjp7InR5cGUiOiJzdHJlYW1hYmxlSHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmR4cmF0aW5nLm5ldC9tY3AifX19) 會開啟應用程式並填好伺服器，你確認後才會加入。 ### 聊天應用程式 #### Claude (claude.ai, Claude Desktop, Claude mobile) 1. 開啟 [加入 Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=DXRating&connectorUrl=https%3A%2F%2Fmcp.dxrating.net%2Fmcp)，或進入 **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 不能加入連接器，在網頁或桌面版加入後會同步過去。 文件：https://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。 能否使用取決於你的方案和工作區設定。 文件：https://developers.openai.com/api/docs/guides/custom-mcp-server #### Cherry Studio 一鍵加入：[加入 Cherry Studio](cherrystudio://mcp/install?servers=eyJtY3BTZXJ2ZXJzIjp7ImR4cmF0aW5nIjp7InR5cGUiOiJzdHJlYW1hYmxlSHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmR4cmF0aW5nLm5ldC9tY3AifX19)。加入後伺服器預設是關閉的，確認後再開啟。手動加入：**設定 → MCP → MCP 伺服器 → 新增 → 從 JSON 匯入**，貼上： ```json { "mcpServers": { "dxrating": { "type": "streamableHttp", "url": "https://mcp.dxrating.net/mcp" } } } ``` 請保留 `"type": "streamableHttp"`。少了它 Cherry Studio 會用舊的 SSE 連線，然後失敗。 文件：https://docs.cherryai.com.cn/advanced-basic/extensions/mcp ### 程式開發工具 #### Claude Code ```sh claude mcp add --transport http --scope user dxrating https://mcp.dxrating.net/mcp ``` 用 `claude mcp list` 或 `/mcp` 檢查。專案的 `.mcp.json` 要寫上 `"type": "http"`： ```json { "mcpServers": { "dxrating": { "type": "http", "url": "https://mcp.dxrating.net/mcp" } } } ``` 文件：https://code.claude.com/docs/en/mcp #### Cursor [加入 Cursor](https://cursor.com/en/install-mcp?name=dxrating&config=eyJ1cmwiOiJodHRwczovL21jcC5keHJhdGluZy5uZXQvbWNwIn0%3D)，或寫進 `~/.cursor/mcp.json`： ```json { "mcpServers": { "dxrating": { "url": "https://mcp.dxrating.net/mcp" } } } ``` 文件：https://cursor.com/docs/mcp #### VS Code (GitHub Copilot) [加入 VS Code](https://vscode.dev/redirect/mcp/install?name=dxrating&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.dxrating.net%2Fmcp%22%7D)，或執行： ```sh code --add-mcp '{"name":"dxrating","type":"http","url":"https://mcp.dxrating.net/mcp"}' ``` `.vscode/mcp.json` 和使用者設定的 `mcp.json` 最上層的鍵是 `servers`，不是 `mcpServers`： ```json { "servers": { "dxrating": { "type": "http", "url": "https://mcp.dxrating.net/mcp" } } } ``` 文件：https://code.visualstudio.com/docs/agent-customization/mcp-servers #### Codex (CLI, IDE extension, ChatGPT desktop app) ```sh codex mcp add dxrating --url https://mcp.dxrating.net/mcp ``` 或寫進 `~/.codex/config.toml`（IDE 擴充功能和 ChatGPT 桌面版共用這個檔案）： ```toml [mcp_servers.dxrating] url = "https://mcp.dxrating.net/mcp" ``` 文件：https://learn.chatgpt.com/docs/extend/mcp #### Gemini CLI ```sh gemini mcp add --transport http -s user dxrating https://mcp.dxrating.net/mcp ``` 或在 `~/.gemini/settings.json` 裡用 `httpUrl`（在 Gemini 裡 `url` 代表舊的 SSE）： ```json { "mcpServers": { "dxrating": { "httpUrl": "https://mcp.dxrating.net/mcp" } } } ``` 文件：https://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](https://creativecommons.org/licenses/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。或者： ```sh 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"}' ``` ## 連結 - 網站：https://dxrating.net - 本頁的 Markdown：https://mcp.dxrating.net/index.md?lang=zh-Hant · 給 Agent 的：https://mcp.dxrating.net/llms.txt - Server card：https://mcp.dxrating.net/mcp/server-card - 原始碼：https://github.com/gekichumai/dxrating（apps/backend/src/services/mcp） - 回報問題：https://github.com/gekichumai/dxrating/issues --- 步驟於 2026 年 10 月依各應用程式的文件核對。應用程式的選單經常變動，如果哪一步過時了，請[開 Issue](https://github.com/gekichumai/dxrating/issues)。 其他語言: [English](https://mcp.dxrating.net/index.md?lang=en) · [日本語](https://mcp.dxrating.net/index.md?lang=ja) · [简体中文](https://mcp.dxrating.net/index.md?lang=zh-Hans) · [繁體中文](https://mcp.dxrating.net/index.md?lang=zh-Hant)