osu-mcp: クラウドが平易な英語であなたのosu!の統計を分析できるMCPサーバー

osu-mcp は、Claude Desktop（または任意のMCPクライアント）が osu! API v2 と通信できるようにするMCPサーバーです。現在、公式MCPレジストリに io.github.Osyanne/osu-mcp として公開されています。リポジトリは github.com/Osyanne/osu-mcp、PyPIパッケージは osu-mcp（MITライセンス、PR歓迎）です。

機能 — 12のツール

• プレイヤープロフィール + スコア履歴（ベスト / 最近 / #1）
• ビートマップ検索（フィルター：BPM、難易度、長さ、ステータス）
• グローバル + 国別ppランキング
• マップ別リーダーボード（Modフィルター対応）
• ニュース投稿 + 季節の背景

作者アカウントでの実デモ

Claudeへの指示：「自分のトップ10プレイを表示し、次にエクアドルのトップ5プレイヤーと比較して」

Claudeはトッププレイ（例：208.88pp Dear My Friend DT、206.33pp happy*lucky DT）を取得し、ECの国別リーダーボードを取得。3人のプレイヤー間でpp獲得効率を計算。結果：作者の精度（98.18%）はエクアドル1位と同一 — 差はスキルではなくプレイ量であることが判明。作者は「手動では絶対に計算しなかった」と述べています。

セットアップ手順

uv tool install osu-mcp

https://osu.ppy.sh/home/account/edit でOAuthアプリを作成し（「New OAuth Application」をクリック、コールバックは空白）、claude_desktop_config.json に追加：

"osu": {
  "command": "uvx",
  "args": ["osu-mcp"],
  "env": { "OSU_CLIENT_ID": "...", "OSU_CLIENT_SECRET": "..." }
}

Claudeを再起動。完了。

対象ユーザー

osu! プレイヤーやデータアナリストで、APIレスポンスを手動で解析せずにAIによるパフォーマンス分析を希望する方。