MCP.Market

osu! MCP server

by Osyanne·io.github.Osyanne/osu-mcp·v0.1.4
No reviews yet

MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

0 stars18 downloads/wk

Reviews

Write one

Nobody has reviewed osu! MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

osu! MCP tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan16 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 127 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How osu! MCP compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 40% of 3,470 Web search servers
Downloads a week
18
more than 5% of 827 Web search servers with a package

Install osu! MCP in Claude Code, Cursor or VS Code

claude mcp add osu-mcp -- uvx osu-mcp
Add to Cursor

What the publisher says

From the osu! MCP repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.Osyanne/osu-mcp -->

osu-mcp

osu-mcp is a Model Context Protocol (MCP) server that exposes the osu! API v2 as tools for Claude Desktop and other MCP clients. Ask Claude about your osu! profile, compare players, search beatmaps, browse rankings — all in natural language.

Quickstart

1. Install

uv tool install osu-mcp
# or
pip install osu-mcp

2. Get osu! API credentials

  1. Go to
  2. Scroll to OAuth, click New OAuth Application
  3. Name: anything (e.g., "Claude Desktop"); Callback URL: leave blank.
  4. Copy the Client ID and Client Secret.

3. Configure credentials

Option A — environment variables (recommended):

export OSU_CLIENT_ID=12345
export OSU_CLIENT_SECRET=your-client-secret

Option B — config file at ~/.config/osu-mcp/config.toml (Linux/Mac) or %APPDATA%\osu-mcp\config.toml (Windows):

client_id = 12345
client_secret = "your-client-secret"

4. Wire up Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "osu": {
      "command": "uvx",
      "args": ["osu-mcp"],
      "env": {
        "OSU_CLIENT_ID": "12345",
        "OSU_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Restart Claude Desktop. You should see "osu" in the MCP servers list.

Available tools (12)

Full reference: docs/tools.md.

Examples

In Claude Desktop, try:

"Show me peppy's osu! stats"

"Compare Cookiezi and WhiteCat on accuracy and pp"

"What are the top 10 osu! players from Ecuador?"

"Find me some 200 BPM streamy ranked maps"

Development

git clone https://github.com/Osyanne/osu-mcp.git
cd osu-mcp
uv sync
uv run pytest                      # unit + smoke
uv run pytest -m integration       # integration (needs real creds)
uv run ruff check .
uv run mypy --strict src/

License

MIT — see LICENSE.

Nothing above is checked by us. What we check is on the safety report.

osu! MCP: common questions

Is osu! MCP server safe?
Mostly: it is graded B (72/100). Read the osu! MCP safety report
How do I install osu! MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does osu! MCP need an API key?
Yes. The registry entry asks for OSU_CLIENT_SECRET.
Is osu! MCP maintained?
The last commit was 165 days ago (2026-05-23). The latest release is v0.1.4.
What can I use instead of osu! MCP?
Servers from other publishers that do the same job: obsei MCP server.
How does osu! MCP compare with other Web search MCP servers?
safety score 72/100 (higher than 40% of 3,470 Web search servers); downloads a week 18 (more than 5% of 827 Web search servers with a package). Full comparison.

Alternatives to osu! MCP

Same job from other publishers: the closest match first, then the best rated.

  • obsei
    Self-hosted customer feedback with PII stripped at ingest: search, stats and themes with citations.
    A