# RoselineMCP

> RoselineMCP is an open-source MCP server for developer tools. Roslyn-based C# code navigation and surgical edits so agents read less source. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://atypical-consulting.github.io/RoselineMCP/
- **Repository:** https://github.com/atypical-consulting/roselinemcp
- **MCP Registry name:** io.github.Atypical-Consulting/roseline-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

RoselineMCP is a .NET server that loads your solution with MSBuildWorkspace and answers structural questions with the compiler's own semantics, so references, overloads and generics resolve rather than being string-matched. Instead of reading whole files, an agent asks for a file's shape, a symbol's references, callers or implementers.

The project reports a median 85% fewer tokens per task (93% pooled) compared with reading the files, measured on its own source over 430 symbols, with weak cases published. One example: `search_symbols` on Program.cs went from 2,093 tokens to 120.

Edits are surgical, replacing, adding or deleting a member or renaming a symbol with a diff and preview by default. The write tools refuse an edit that would break the build. It runs over stdio through `dnx RoselineMCP --yes` and needs the .NET 10 SDK, or via a dotnet tool, Docker or an MCPB bundle.

## Features

- **Symbol navigation:** Symbols, references, call graphs and type hierarchies from Roslyn.
- **Surgical edits:** Member-level changes and solution-wide rename with unified diff.
- **Compile guard:** Write tools refuse edits that break the build.
- **Analysis and fixes:** Runs Roslyn analyzers and code fix providers.
- **Several install routes:** dnx, dotnet tool, Docker or Claude Desktop bundle.

## Good for

- Find every caller of a method in a large solution
- Rename a symbol safely across projects
- Get a file's outline without reading its body
- Apply analyzer fixes with a previewed diff

## Install

### Claude Code (Terminal)

```sh
claude mcp add roseline-mcp -- dnx RoselineMCP --yes
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "roseline-mcp": {
      "command": "dnx",
      "args": [
        "RoselineMCP",
        "--yes"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "roseline-mcp": {
      "command": "dnx",
      "args": [
        "RoselineMCP",
        "--yes"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "roseline-mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "RoselineMCP",
        "--yes"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "roseline-mcp": {
      "command": "dnx",
      "args": [
        "RoselineMCP",
        "--yes"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "roseline-mcp": {
      "command": "dnx",
      "args": [
        "RoselineMCP",
        "--yes"
      ]
    }
  }
}
```

## Tools

- `search_symbols`: Return the shape of a file or search symbols
- `find_references`: Find exact references to a symbol
- `rename_symbol`: Rename a symbol across the solution

## FAQ

### What does it need?

The .NET 10 SDK for dnx; Docker needs no host .NET.

### Which clients are verified?

Claude Desktop, VS Code (Copilot/MCP) and Cursor.

### Are edits applied immediately?

Preview is the default, and the compile guard blocks edits that break the build.

### What licence?

MIT, per the README badge.

### Is RoselineMCP free?

Yes. RoselineMCP is open source, so you can use and self-host it for free.

### How do I add RoselineMCP to Claude Code?

Run this command in your terminal: claude mcp add roseline-mcp -- dnx RoselineMCP --yes

### What are the best alternatives to RoselineMCP?

The closest alternatives to RoselineMCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/roselinemcp
