C# semantic rename, code actions, fix-all, formatting and diagnostics via Microsoft's Roslyn server
Maintain this server? Claim it
This server only runs locally, from a package. Install it with the instructions on this page to try it.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add claude-roslyn-lsp \ -- dnx [email protected] --yes
Environment
CLAUDE_ROSLYN_LSP_SOLUTION (optional, not in the config above): Path to the .slnx, .sln or .csproj to load. Optional: the adapter discovers one from the working directory, honouring .vscode/settings.json's dotnet.defaultSolution. Set it in a monorepo, where discovery picks a solution that is often not the one being worked in. A path that does not exist is a startup failure rather than a fall back to discovery.CLAUDE_ROSLYN_LSP_ROSLYN_PATH (optional, not in the config above): Directory holding an already-installed Microsoft.CodeAnalysis.LanguageServer.dll, used instead of downloading one. Optional; set it to run air-gapped or against a locally built server. Its version is not checked. Alias: CLAUDE_ROSLYN_LSP_SERVER_PATH.CLAUDE_ROSLYN_LSP_ROSLYN_VERSION (optional, not in the config above): Overrides the pinned roslyn-language-server version the adapter downloads from nuget.org. Optional; the pin is the only version this release is tested against, an override has no hash to verify against, and doctor reports it as unverified. Alias: CLAUDE_ROSLYN_LSP_SERVER_VERSION.CLAUDE_ROSLYN_LSP_ROSLYN_ARGS (optional, not in the config above): Extra arguments for the Roslyn child process, split on whitespace with no quoting. Development only: it exists so the smoke test can point the launcher at this binary's own scripted backend.CLAUDE_ROSLYN_LSP_CACHE_DIR (optional, not in the config above): Where downloaded Roslyn servers are extracted. Optional; defaults to a directory under the adapter's home. Moves the payloads only - logs and staged downloads stay under the home.CLAUDE_ROSLYN_LSP_HOME (optional, not in the config above): The adapter's per-user state directory: downloads, logs and lock files. Optional; unset, it falls back to CLAUDE_PLUGIN_DATA and then to the platform cache location (%LOCALAPPDATA%, ~/Library/Caches, $XDG_CACHE_HOME or ~/.cache). Around 140 MB extracted per Roslyn version per platform, so it belongs on a disk with room and outside a roaming profile.CLAUDE_ROSLYN_LSP_OFFLINE (optional, not in the config above): Set to 1 to refuse to download a Roslyn server. A missing cache entry becomes an immediate, explained failure instead of a 70 MB fetch. Accepts 1/true/yes/on and 0/false/no/off; default 0.CLAUDE_ROSLYN_LSP_TRANSPORT (optional, not in the config above): How the adapter talks to the Roslyn child process: pipe (default) or stdio. The named pipe is preferred because Roslyn writes a startup banner to its own stdout, which under stdio shares a stream with the protocol.CLAUDE_ROSLYN_LSP_READY_TIMEOUT_SECONDS (optional, not in the config above): How long a call waits for the workspace to finish loading before it is answered anyway, 1-3600, default 120. Tools report status "loading" rather than hanging while they wait.CLAUDE_ROSLYN_LSP_DIAGNOSTICS (optional, not in the config above): The pull-to-push diagnostics bridge, on by default. Applies to the lsp verb only: an MCP client asks for diagnostics with getDiagnostics instead. Accepts 1/true/yes/on and 0/false/no/off.CLAUDE_ROSLYN_LSP_DIAGNOSTIC_MIN_SEVERITY (optional, not in the config above): The severity floor applied before diagnostics are pushed to an LSP client: error, warning (default), information or hint. The MCP getDiagnostics tool takes its own minSeverity argument instead.CLAUDE_ROSLYN_LSP_WORKSPACE_DIAGNOSTICS (optional, not in the config above): Opt-in workspace-wide diagnostics for files that are not open, for the lsp verb. Off unless set, because it needs a full-solution compiler scope, which is what makes a large solution slow.CLAUDE_ROSLYN_LSP_FILE_WATCHER (optional, not in the config above): The file-watch bridge, on by default. Without it a file created by a shell command or by git never joins its project and every later answer is silently stale. Accepts 1/true/yes/on and 0/false/no/off.CLAUDE_ROSLYN_LSP_SHARE (optional, not in the config above): Whether the lsp and mcp servers share one Roslyn per solution, on by default. Off makes each of them launch a Roslyn of its own, which loads the solution twice and pays for it twice in memory. getWorkspaceStatus reports engine: owned or attached, so which of the two happened is never a guess.CLAUDE_ROSLYN_LSP_GC (optional, not in the config above): Which garbage collector the Roslyn child runs with: workstation (the default) or server. Workstation peaks at about 577 MB on a 239-project solution where server peaks at about 2 GB, and costs about 8 seconds of load time. An explicit DOTNET_gcServer in the environment wins over this.CLAUDE_ROSLYN_LSP_GC_CONSERVE (optional, not in the config above): The DOTNET_GCConserveMemory level, 0-9, the Roslyn child runs with: it caps how far the child's heap may grow past its live data, so less free space stays committed after a compacting collection. Default 7; 0 sets nothing. An explicit DOTNET_GCConserveMemory in the environment wins over this.CLAUDE_ROSLYN_LSP_IDLE_RECYCLE_MINUTES (optional, not in the config above): How long the session has to be idle before a Roslyn child that has grown past its threshold is stopped to give its memory back; the next call relaunches it and waits for the reload. Default 20; 0 switches the recycle off.CLAUDE_ROSLYN_LSP_RECYCLE_GROWTH_FACTOR (optional, not in the config above): How far past its post-load baseline the Roslyn child has to have grown before an idle recycle is worth a reload: the threshold is the larger of baseline times this factor and baseline plus 512 MB. A decimal, 1.2-20, default 2.CLAUDE_ROSLYN_LSP_IDLE_SHUTDOWN_MINUTES (optional, not in the config above): Stop the Roslyn child after this many idle minutes whatever its size; the next call relaunches it. Default 0, which is off, because every relaunch costs a full solution load.CLAUDE_ROSLYN_LSP_LOG_LEVEL (optional, not in the config above): Trace, Debug, Information, Warning, Error, Critical or None (default Information). Logs go to stderr only - stdout is the JSON-RPC channel.CLAUDE_ROSLYN_LSP_ROSLYN_LOG_LEVEL (optional, not in the config above): The level handed to the Roslyn child process, default Warning. Its Information level is about twenty lines of narration per start, all of it on this adapter's stderr.CLAUDE_ROSLYN_LSP_OPTIONS (optional, not in the config above): A JSON object merged into the answers the adapter gives Roslyn's workspace/configuration requests, for the sections the defaults get wrong for your repository. A syntax error is a logged warning, never a startup failure.We don't run packages, so we can't list this server's tools.