osu-mcp: Un servidor MCP que permite a Claude analizar tus estadísticas de osu! en lenguaje sencillo

osu-mcp es un servidor MCP que permite a Claude Desktop (o cualquier cliente MCP) comunicarse con la API v2 de osu!. Ahora está publicado en el registro oficial de MCP como io.github.Osyanne/osu-mcp. El repositorio es github.com/Osyanne/osu-mcp y el paquete PyPI es osu-mcp (licencia MIT, se aceptan PRs).

Qué hace — 12 herramientas

• Perfiles de jugadores + historial de puntuaciones (mejores / recientes / #1)
• Búsqueda de beatmaps con filtros (BPM, dificultad, duración, estado)
• Clasificaciones globales y por país de pp
• Tablas de clasificación por mapa, filtrables por mods
• Publicaciones de noticias + fondos de temporada

Demostración real con la cuenta del autor

A Claude se le pidió: "Muéstrame mis 10 mejores jugadas y luego compárame con los 5 mejores jugadores de Ecuador."

Claude obtuvo las mejores jugadas (por ejemplo, 208.88 pp Dear My Friend DT, 206.33 pp happy*lucky DT), tomó la clasificación del país EC y calculó la eficiencia de pp por jugada en los tres jugadores. La conclusión: la precisión del autor (98.18%) es idéntica a la del jugador #1 de Ecuador; la diferencia es el volumen, no la habilidad. Un cálculo que el autor afirma que nunca habría hecho manualmente.

Instrucciones de configuración

uv tool install osu-mcp

Crea una aplicación OAuth en https://osu.ppy.sh/home/account/edit (haz clic en "New OAuth Application", deja el campo callback en blanco), luego añade a claude_desktop_config.json:

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

Reinicia Claude. Listo.

Para quién es

Jugadores de osu! y analistas de datos que quieran desgloses asistidos por IA de su rendimiento sin tener que revisar manualmente las respuestas de la API.