osu-mcp: Um Servidor MCP que Permite ao Claude Analisar suas Estatísticas do osu! em Inglês Simples

osu-mcp é um servidor MCP que permite ao Claude Desktop (ou qualquer cliente MCP) se comunicar com a API v2 do osu!. Agora está publicado no Registro MCP oficial como io.github.Osyanne/osu-mcp. O repositório é github.com/Osyanne/osu-mcp e o pacote PyPI é osu-mcp (licença MIT, PRs são bem-vindos).

O Que Ele Faz — 12 Ferramentas

• Perfis de jogadores + histórico de pontuações (melhores / recentes / #1s)
• Busca de beatmaps com filtros (BPM, dificuldade, duração, status)
• Rankings globais e por país de pp
• Leaderboards por mapa, filtráveis por mods
• Postagens de notícias + backgrounds sazonais

Demonstração Real na Conta do Autor

Claude recebeu o comando: "Mostre meus 10 melhores plays e depois me compare com os 5 melhores jogadores do Equador."

Claude puxou os melhores plays (ex.: 208.88 pp Dear My Friend DT, 206.33 pp happy*lucky DT), buscou o leaderboard do Equador e calculou a eficiência pp por jogada nos três jogadores. A conclusão: a precisão do autor (98,18%) é idêntica à do #1 do Equador — a diferença é volume, não habilidade. Um cálculo que o autor diz que nunca teria feito manualmente.

Instruções de Configuração

uv tool install osu-mcp

Crie um app OAuth em https://osu.ppy.sh/home/account/edit (clique em "New OAuth Application", deixe o callback em branco) e depois adicione ao claude_desktop_config.json:

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

Reinicie o Claude. Pronto.

Para Quem é

Jogadores de osu! e analistas de dados que querem análises assistidas por IA de seu desempenho sem ter que vasculhar respostas da API manualmente.