osu-mcp: 클로드가 일반 영어로 osu! 통계를 분석할 수 있게 해주는 MCP 서버

osu-mcp는 클로드 데스크톱(또는 모든 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 순위
• 맵별 리더보드, 모드별 필터링 가능
• 뉴스 게시물 + 시즌 배경화면

작성자 계정으로 실제 데모

클로드에게 요청: "내 상위 10개 플레이를 보여주고, 에콰도르 상위 5명의 플레이어와 비교해 줘."

클로드가 상위 플레이(예: 208.88pp Dear My Friend DT, 206.33pp happy*lucky DT)를 가져오고, EC 국가 리더보드를 불러와 세 플레이어 모두의 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": "..." }
}

클로드를 재시작하면 완료.

대상 사용자

API 응답을 직접 뒤지지 않고 AI 기반의 성능 분석을 원하는 osu! 플레이어 및 데이터 분석가.