Is io.github.Osyanne/osu-mcp safe to use?

io.github.Osyanne/osu-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.Osyanne/osu-mcp?

io.github.Osyanne/osu-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.Osyanne/osu-mcp do?

io.github.Osyanne/osu-mcp provides 12 tools: get_user_summary, compare_users, get_user_scores, get_score_details, search_beatmaps and 7 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.Osyanne/osu-mcp?

io.github.Osyanne/osu-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.Osyanne/osu-mcp actively maintained?

io.github.Osyanne/osu-mcp is recently maintained — last commit was 38 days ago.

io.github.Osyanne/osu-mcp

osu-mcp

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

12 tools GitHub PyPI

No known CVEs

No license

Maintained

Last commit 38d ago

Works with most clients

Transport: stdio

12 tools · ~518 tok

Grade B · 0.3% of 200K ctx

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-osyanne-osu-mcp)](https://mcppedia.org/s/io-github-osyanne-osu-mcp)

Read me

What io.github.Osyanne/osu-mcp does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'osu-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

78/100across 5 weighted dimensions

How we score →

0255075100

−22

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked osu-mcp against OSV.dev.

Inventory

Tools (12)

Click any tool to inspect its schema.

~518 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Osyanne/osu-mcp safe to use?: io.github.Osyanne/osu-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.Osyanne/osu-mcp?: io.github.Osyanne/osu-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.Osyanne/osu-mcp do?: io.github.Osyanne/osu-mcp provides 12 tools: get_user_summary, compare_users, get_user_scores, get_score_details, search_beatmaps and 7 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.Osyanne/osu-mcp?: io.github.Osyanne/osu-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.Osyanne/osu-mcp actively maintained?: io.github.Osyanne/osu-mcp is recently maintained — last commit was 38 days ago.

Similar servers

Others in other

View all →

Pi Lean Ctx95

Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.

3.0k 6

Headroom95

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.

55.0k 3

Sigmap94

97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server

531 6

io.github.asklokesh/loki-mode94

Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.

997 8

MCP Security Weekly

Get CVE alerts and security updates for io.github.Osyanne/osu-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-osyanne-osu-mcp)](https://mcppedia.org/s/io-github-osyanne-osu-mcp)

Read me

What io.github.Osyanne/osu-mcp does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'osu-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

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

Go to https://osu.ppy.sh/home/account/edit
Scroll to OAuth, click New OAuth Application
Name: anything (e.g., "Claude Desktop"); Callback URL: leave blank.
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 claude_desktop_config.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)

Tool	Description
`get_user_summary`	Profile + stats; optionally embed recent/best/firsts scores
`compare_users`	Side-by-side comparison of 2-5 users
`get_user_scores`	List a user's best/recent/firsts scores
`get_score_details`	Full attributes of a specific score
`search_beatmaps`	Search beatmapsets with filters (mode, status, difficulty, length, BPM)
`get_beatmap_details`	Full attributes of a beatmap (AR/OD/CS/HP, BPM, max combo)
`get_beatmap_scores`	Top scores on a beatmap, filterable by mods
`get_beatmapset`	Full beatmapset with all difficulties
`get_rankings`	pp/score/charts rankings, global or by country
`get_country_top`	Top N players of a country in pp ranking
`get_news_posts`	Recent osu! news posts
`get_seasonal_backgrounds`	Active seasonal backgrounds

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.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

78/100across 5 weighted dimensions

How we score →

0255075100

−22

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked osu-mcp against OSV.dev.

Inventory

Tools (12)

Click any tool to inspect its schema.

~518 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Osyanne/osu-mcp safe to use?: io.github.Osyanne/osu-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.Osyanne/osu-mcp?: io.github.Osyanne/osu-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.Osyanne/osu-mcp do?: io.github.Osyanne/osu-mcp provides 12 tools: get_user_summary, compare_users, get_user_scores, get_score_details, search_beatmaps and 7 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.Osyanne/osu-mcp?: io.github.Osyanne/osu-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.Osyanne/osu-mcp actively maintained?: io.github.Osyanne/osu-mcp is recently maintained — last commit was 38 days ago.

Similar servers

Others in other

View all →

Pi Lean Ctx95

Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.

3.0k 6

Headroom95

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.

55.0k 3

Sigmap94

97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server

531 6

io.github.asklokesh/loki-mode94

Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.

997 8

MCP Security Weekly

Get CVE alerts and security updates for io.github.Osyanne/osu-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?