Sonarvue MCP installer

Install the Sonarvue MCP server into your coding agents with a single command.

npx @sonarvue/mcp

That's it. The CLI detects which agents you use, writes the correct config for each one, and registers the Sonarvue hosted MCP server (https://mcp.sonarvue.com/mcp, streamable HTTP).

The installer opens a browser tab where you sign in, approve your Sonarvue workspace, and create a revocable MCP token — the callback is caught automatically on 127.0.0.1:14123 and written into each harness config as an Authorization: Bearer tk_… header. Revoke any time under Settings → Integrations → MCP.

Non-interactive runs (CI, scripts) skip the browser: pass SONARVUE_MCP_TOKEN, --header 'Authorization: Bearer tk_…', or set SONARVUE_SKIP_LOGIN=1 to install without a token.

Supported agents

Claude Code, Claude Desktop, Codex, Cursor, OpenCode, VS Code, Windsurf, Zed, Gemini CLI, Goose, GitHub Copilot CLI, Antigravity, Cline, Grok Build, MCPorter, and more:

npx @sonarvue/mcp list-agents

Options

| Option | Description | | ------------------------ | --------------------------------------------------------------------------------------- | | [target] | Install a different MCP server URL or npm package instead of Sonarvue's hosted endpoint | | -g, --global | Install to user-level config instead of the current project | | -a, --agent <agent> | Target specific agents (repeatable), e.g. -a cursor -a claude-code | | --all | Install to all supported agents | | -y, --yes | Skip confirmation prompts | | -n, --name <name> | Server name (defaults to sonarvue) | | -t, --transport <type> | Transport for remote servers: http (default) or sse | | --scopes <scopes> | OAuth scopes for remote servers (comma-separated; capability-gated per agent) |

Examples

# Interactive install into every detected agent (project scope)
npx @sonarvue/mcp

# Non-interactive install for specific agents
npx @sonarvue/mcp -y -a cursor -a claude-code

# User-level install so every project gets Sonarvue
npx @sonarvue/mcp -g -y

# Self-hosted Sonarvue deployment
npx @sonarvue/mcp https://mcp.sonarvue.acme.com/mcp

The default target can also be overridden with the SONARVUE_MCP_URL environment variable.

Other commands

| Command | Description | | ---------------- | ---------------------------------------------------- | | list-agents | List all supported coding agents | | find <keyword> | Search public MCP registries for other servers | | list | List installed MCP servers across detected agents | | remove <query> | Remove an MCP server from agent configurations | | sync | Synchronize server names/installations across agents |

Development

Requires Node.js 18+.

npm install
npm run build       # bundle src/ -> dist/ (tsup)
npm run typecheck   # tsc --noEmit
npm test            # unit + e2e tests (tsx)
npm run dev         # run the CLI from source

CI runs typecheck, tests, and build on every push and pull request.

Attribution

This installer is built on add-mcp by Neon, licensed under the Apache License 2.0. See LICENSE.