# DXRating MCP サーバー maimai DX を AI アシスタントに。このサーバーを接続すると、Claude、ChatGPT、Cursor、VS Code、Cherry Studio などの AI アプリが DXRating（dxrating.net）の楽曲と譜面を曲名・別名で探し、日本・インターナショナル・USA・中国版の譜面定数を調べ、レーティングやベスト枠（Best 50）を計算できます。 MCP（Model Context Protocol）は、AI アプリが外部のツールにつながるための標準の仕組みです。 **無料 · アカウント不要 · API キー不要 · 読み取り専用** ## エージェントに設定してもらう Claude Code、Codex、Cursor などのコーディングエージェントに貼り付けてください： ```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)を開くか、**カスタマイズ → コネクタ → + 追加 → カスタムコネクタを追加** を開きます。 2. 名前：`DXRating`。リモート MCP サーバーの URL：`https://mcp.dxrating.net/mcp`。**続行** を押します。 3. **認証** で **サインインなし** を選び、**追加** を押します。 4. チャットで **+ → コネクタ** を開き、DXRating をオンにします。 無料プランで追加できるカスタムコネクタは 1 つです。Team・Enterprise プランではオーナーが **組織の設定 → コネクタ** で追加し、メンバーが **接続** を押します。モバイルアプリでは追加できないので、Web かデスクトップで追加すると同期されます。 ドキュメント：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. 認証は **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"` は消さないでください。ないと古い 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` のキーは `mcpServers` ではなく `servers` です： ```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、Streamable HTTP、認証なしでリモート MCP サーバーを追加してください。多くのアプリ（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、简体中文、繁體中文のどれで聞いても大丈夫です。曲名、別名、愛称で探せます。 - 「bbb」ってどの曲？ 各譜面のレベルも教えて。 - PANDORA PARADOXXX の Re:MASTER の譜面定数を、日本版・インターナショナル版・中国版で比べて。 - インターナショナル版で、レベル 14 の中で定数が一番低い譜面は？ - 系ぎて の MASTER で 100.5% だとレートはいくつ？ 300 にするには何％必要？ - 私のベストスコアはこれ：… レートはいくつで、どの譜面から上げるといい？ - PANDORA PARADOXXX の MASTER の定数はバージョンごとに変わった？ **動作の確認：**「DXRating を使って、系ぎて の MASTER の譜面定数を教えて」と聞いてみてください。サーバーとバージョンを示し、DXRating をクレジットしていれば正常です。ツールを使わずに答えた場合は「DXRating のツールを使って」と伝えてください。 ## ツール すべて読み取り専用です。公開の楽曲データを読むだけで、アカウントを見たり変えたりはできません。 | ツール | 内容 | |---|---| | `search_songs` | 曲名・別名・愛称・ローマ字・アーティストで楽曲を探し、各譜面のレベルを返す | | `get_sheet` | 楽曲と譜面の詳細：現在と過去のバージョンの譜面定数、ノーツ数、譜面作者、サーバー、タグ | | `calculate_rating` | 譜面と達成率からレート、目標レートに必要な達成率、各ランクのレート | | `calculate_best50` | 貼り付けたスコアからレート：新曲枠 15 と旧曲枠 35、伸ばすべき譜面 | ## データとライセンス - 楽曲・譜面・別名・タグは DXRating（dxrating.net）のもので、ゲームのアップデートごとに更新されます。譜面定数はサーバーによって違うことがあります：jp（日本）、intl（インターナショナル）、usa、cn。アシスタントがどれか聞くか、jp を使います。 - ツールが受け取り返す達成率は 1/10000 % 単位の整数です：100.7543% は `1007543`。変換はアシスタントがします。 - レートはゲームと同じ計算です：ベスト枠は現行バージョンの上位 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 アドレスごとに 1 分あたり 300 リクエスト。質問 1 つで通常 1〜4 リクエストです。 - 超えると「Too many requests. Retry in N seconds.」と返します。その秒数待ってから再試行してください。 - Claude.ai と ChatGPT は各社のサーバーから接続するため、利用者どうしで制限を共有することがあります。 - ベスト枠の計算は 1 回につきスコア 300 件までです。 ## プライバシー - アカウント、キー、Cookie はありません。このページは外部のスクリプトを読み込まず、アクセス解析もしていません。 - サーバーが受け取るのはアシスタントが送るもの、つまりツール名と引数（曲名や貼り付けたスコアなど）だけです。会話は見えず、スコアも保存しません。 - リクエストごとに時刻、パス、ステータス、所要時間、リクエストヘッダー（IP アドレスと User-Agent を含む）を記録します。ツールの引数が入る本文は記録しません。記録は監視サービス（Sentry）に送られ、運用と不正利用の防止にだけ使います。 - リクエストは Cloudflare を通り、Cloudflare の規約に従って処理されます。 ## うまくいかないとき - **接続できない、SSE のエラー、405：** アプリが古い SSE で接続しようとしています。このサーバーは対応していません。Streamable HTTP を選んでください：Cherry Studio は `"type": "streamableHttp"`、Gemini CLI は `httpUrl`。 - **サインインを求められる：** サインインは不要です。「サインインなし」「No authentication」を選んでください。 - **ブラウザで `/mcp` を開くとこのページになる：** 正常です。エンドポイントは AI アプリからの POST だけを受け付けます。 - **「still loading its song catalog」：** サーバーが再起動した直後です。1 分ほどして再試行してください。 - **追加したのにツールが使われない：** チャットでコネクタをオンにし、「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"}' ``` ## リンク - Web サイト：https://dxrating.net - この案内の Markdown：https://mcp.dxrating.net/index.md?lang=ja · エージェント向け：https://mcp.dxrating.net/llms.txt - サーバーカード：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)