Skip to content
mcp/harbor
VS Code

osu! MCP for VS Code

io.github.osyanne/osu-mcp

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

client:VS Code transport:stdio runtime:pypi

Install osu! MCP in VS Code

.vscode/mcp.json 

{
  "inputs": [
    {
      "type": "promptString",
      "id": "osu-client-id",
      "description": "OSU_CLIENT_ID",
      "password": true
    },
    {
      "type": "promptString",
      "id": "osu-client-secret",
      "description": "OSU_CLIENT_SECRET",
      "password": true
    }
  ],
  "servers": {
    "osu-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "osu-mcp"
      ],
      "env": {
        "OSU_CLIENT_ID": "${input:osu-client-id}",
        "OSU_CLIENT_SECRET": "${input:osu-client-secret}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

osu! MCP in other clients

osu! MCP MCP server