osu-mcp: Ein MCP-Server, der Claude ermöglicht, deine osu!-Statistiken in einfachem Englisch zu analysieren

osu-mcp ist ein MCP-Server, der es Claude Desktop (oder jedem MCP-Client) ermöglicht, mit der osu! API v2 zu kommunizieren. Er ist jetzt im offiziellen MCP Registry als io.github.Osyanne/osu-mcp veröffentlicht. Das Repository ist github.com/Osyanne/osu-mcp und das PyPI-Paket heißt osu-mcp (MIT-Lizenz, PRs willkommen).

Was es kann – 12 Tools

• Spielerprofile + Score-Verlauf (beste / aktuelle / #1-Scores)
• Beatmap-Suche mit Filtern (BPM, Schwierigkeit, Länge, Status)
• Globale + länderspezifische pp-Ranglisten
• Pro-Map-Ranglisten, filterbar nach Mods
• News-Beiträge + saisonale Hintergründe

Echte Demo mit dem Konto des Autors

Claude wurde gefragt: „Zeig mir meine Top-10-Plays und vergleiche mich dann mit den Top-5-Spielern aus Ecuador.“

Claude zog die Top-Plays (z.B. 208,88 pp Dear My Friend DT, 206,33 pp happy*lucky DT), holte die EC-Länderrangliste und berechnete die pp-pro-Play-Effizienz über alle drei Spieler. Die Erkenntnis: Die Genauigkeit des Autors (98,18 %) ist identisch mit der des #1-Spielers in Ecuador – die Lücke ist das Volumen, nicht das Können. Eine Berechnung, die der Autor laut eigenen Angaben nie manuell durchgeführt hätte.

Einrichtungsanleitung

uv tool install osu-mcp

Erstelle eine OAuth-App unter https://osu.ppy.sh/home/account/edit (klicke auf „Neue OAuth-Anwendung“, lasse das Callback-Feld leer) und füge dann Folgendes in claude_desktop_config.json hinzu:

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

Starte Claude neu. Fertig.

Für wen es gedacht ist

osu!-Spieler und Datenanalysten, die KI-gestützte Analysen ihrer Leistung wünschen, ohne manuell API-Antworten durchforsten zu müssen.