LspUse.Csharp.osx-arm64 0.0.4

<div align="center">

lsp-use

An MCP interface to bring the structure of C# Language Server to LLMs

</div>

Introduction

By giving LLMs direct access to the same Language Server that humans use through VS Code or other IDEs the codebase becomes more structured and easy to discover and navigate. This shorten the feedback loop, allows for codebase-aware generation and is an efficent use of the model's context.

<details>

<summary>More on the why</summary>

Problem

Consider this scenario where IsReady disappears after a dependency update:

using Your.Company.Lib;

var client = new YourCompanyClient();

if(client.IsReady) // Error after updating!

An LLM like o3 encountering this would typically approach it by either

• attempting to search the local .nuget package folder on the look-out for source code
• write a temp console app that uses reflection to describe the type's symbols

using System;
using Your.Company.Lib;

foreach (var p in typeof(YourCompanyClient).GetProperties())
    Console.WriteLine($"{p.Name} : {p.PropertyType}");

This isn't ideal for multiple reasons:

• longer feedback loops when developing
• more tokens needed so the model's context fills quicker and it costs more
• misses out on the structure of code that is so easy for humans to explore via IDEs

With access to LSP

The LLM can now approach this by first retrieving the type's symbols similarly to what humans would do with autocomplete or source inspection.

For example invoking mcp__csharp__get_symbols(YourCompanyClient.cs) would return

[
  {
    "name": "YourCompanyClient",
    "kind": "Class",
    "location": {
      "text": "public sealed class YourCompanyClient : IYourCompanyClient, IDisposable"
    }
  },
  {
    "name": "IsReadyAsync(CancellationToken ct = default)",
    "kind": "Method",
    "container": "YourCompanyClient",
    "location": {
      "text": "public Task IsReadyAsync(CancellationToken ct = default)"
    }
  },
  {
    "name": "DoWorkAsync(Request request, CancellationToken ct = default)",
    "kind": "Method",
    "container": "YourCompanyClient",
    "location": {
      "text": "public Task<Work> DoWorkAsync(Request request, CancellationToken ct = default)"
    }
  },
]

Benefits

• API Discovery: No more guessing method signatures or writing reflection code
• Accurate Refactoring: LSP-powered rename and find-references across entire codebases
• Rich Context: Full type information, method signatures, documentation, and error diagnostics

</details>

Installation

Install the platform-specific package globally using dotnet tool:

Linux

dotnet tool install --global LspUse.Csharp.linux-x64

Windows

dotnet tool install --global LspUse.Csharp.win-x64

Apple Silicon

dotnet tool install --global LspUse.Csharp.osx-arm64

Configuration

<details>

<summary>Claude Code</summary>

Update your .mcp.json file with a csharp where the path and sln files match the ones of your repo

{
  "mcpServers": {
    "csharp": {
      "command": "lsp-use",
      "args": [
        "--workspace",
        ".",
        "--sln",
        "solution.sln"
      ]
    }
  }
}

Update your CLAUDE.md with instructions on tool use recommending to prefer LSP-based discovery over traditional file read.

</details>

<details>

<summary>OpenAI Codex</summary>

Add or update your $HOME/.codex/config.toml. Doesn't seem to work at repo level yet.

[mcp_servers.csharp]
command = "lsp-use"
args = ["--workspace=/path/to/repo", "--sln=/path/to/repo/solution.sln"]

Update your AGENTS.md with instructions on tool use like here.

</details>

<details>

<summary>Copilot in VS Code</summary>

Add or update your .vscode/mcp.toml to include this csharp server and provide your own solution file name

{
   "servers": {
     "csharp": {
       "type": "stdio",
       "command": "lsp-use",
       "args": [
         "--sln",
         "${workspaceFolder}/solution.sln",
         "--workspace",
         "${workspaceFolder}",
       ]
     }
   }
 }

</details>

Available Tools

The server provides the following tools.

Symbols

• mcp__csharp__search_symbols: Searches for symbols across the entire workspace e.g. ApplicationService or Async
• mcp__csharp__get_symbols: Parses all symbols in a file and returns them file

Code Navigation & Edit

• mcp__csharp__find_references: Returns a list of all the references to a symbol across the codebase
• mcp__csharp__rename_symbol: Renames a symbol across the entire codebase
• mcp__csharp__go_to_definition: Returns the definition location of a symbol
• mcp__csharp__go_to_type_definition: Returns a list of type definition of a symbol
• mcp__csharp__go_to_implementation: Returns a list of implementations of interfaces or abstract members

Diagnostic

• mcp__csharp__get_diagnostics: Returns a list of diagnostics (errors, warnings, hints) for a file. These include codes, error messages, severity and link to Microsoft's code page.

Discovery

• mcp__csharp__hover: Gets XML documentation and description for a given symbol.
• mcp__csharp__completion: Returns a list of code completion suggestions at a specific file and their kinds (available properties, local variables, types, methods)

Troubleshooting

• mcp__csharp__get_window_log_messages: Returns a list of messages from the server. Things like "solution successfully loaded"

Workflows

The tools can be combined to create productive workflows or Claude commands.

Class Discovery & Understanding

• mcp__csharp__search_symbols("ApplicationService") → mcp__csharp__get_symbols(ApplicationService.cs)
• Use case: Understanding what a class does, its methods, dependencies
• Value: Full method signatures show parameters, return types, async patterns without opening files

Interface Analysis

• mcp__csharp__go_to_definition(IApplicationService) → mcp__csharp__find_references(IApplicationService location)
• Use case: Understanding interface contracts and their implementations
• Value: Full line context shows class inheritance, dependency injection registrations

Dependency Mapping

• mcp__csharp__find_references(_rpc field) → mcp__csharp__go_to_type_definition(JsonRpc usage) → mcp__csharp__get_symbols(JsonRpc)
• Use case: Understanding external dependencies and how they're used
• Value: Full context shows field types, available methods

Architecture Navigation

• mcp__csharp__search_symbols("DefinitionAsync") → mcp__csharp__go_to_definition(specific method) → mcp__csharp__find_references(that method)
• Use case: Tracing how functionality flows through layers
• Value: Understand call chains and architectural boundaries

Pattern Analysis

• mcp__csharp__search_symbols("Async") → mcp__csharp__get_symbols(multiple files)
• Use case: Understanding async patterns, naming conventions
• Value: Identify consistency in API design and implementation patterns

Refactoring Planning

• mcp__csharp__find_references(method/field) → mcp__csharp__go_to_definition(each usage context)
• Use case: Impact analysis before making changes
• Value: Assess refactoring scope and identify breaking changes

Type Exploration (Framework/Library APIs)

• mcp__csharp__go_to_type_definition(System.Console) → mcp__csharp__get_symbols(decompiled Console.cs)
• Use case: Understanding available methods/properties on framework types
• Value: Complete API discovery without documentation lookup

Error Analysis & Debugging

• mcp__csharp__get_diagnostics(file.cs) → mcp__csharp__go_to_definition(error location) → mcp__csharp__hover(symbol
• Use case: Understanding compilation errors, warnings, and hints in context
• Value: Provides error codes, messages, severity levels, and links to Microsoft documentation for quick resolution

Symbol Refactoring

• mcp__csharp__find_references(symbol) → mcp__csharp__rename_symbol(filePath, line, character, newName)
• Use case: Safely renaming symbols across the entire codebase
• Value: Automated refactoring with LSP-level accuracy and safety