# 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-Hans · 给 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)