Every version, its notes, and its downloads.
Pulled straight from GitHub Releases at build time. Grab the.mcpb for a one-click Claude Desktop install, or the .nupkg to pin a version.
- v1.4.0latestJul 3, 2026
Added
- MCP structured content + output schema — every tool now advertises an
outputSchemaand emitsstructuredContent(UseStructuredContent = true), so clients get a machine-readable, schema-validated result in addition to the JSON text. - Progress notifications for long-running tools —
AnalyzeSolution,ApplyFixes, andRenameSymbolnow report progress via MCP progress notifications. - Human-readable tool titles and an honest
OpenWorldhint — every tool advertises aTitle;OpenWorldisfalsefor the local-only tools andtrueonly forAnalyzeSolution(which can clone a Git URL). - Write confirmation via MCP elicitation — the write tools (
ApplyFixes,EditMember,RenameSymbol) ask the client to confirm before writing whenpreviewOnly: false; declining downgrades the call to a preview (nothing is written). - Failure logging via MCP logging notifications — tool failures are surfaced to the client's log stream through MCP logging notifications that carry the correlation ID.
Changed
- BREAKING: tools now return a typed
ToolResult<T>envelope instead of a hand-serialized JSON string. The response wire shape changed: success payloads are now nested underdata({ "ok": true, "data": { ... } }) and failures undererror({ "ok": false, "error": { "type", "message", "hint?", "correlationId" } }). The human-readable message moved from the top-levelerrorfield toerror.message;type/hint/correlationIdmoved undererror. Seedocs/API.md. server.jsonwebsiteUrlnow points at the documentation site (https://atypical-consulting.github.io/RoselineMCP/) instead of the GitHub repo. Reaches the live MCP Registry entry on the next published version.
- MCP structured content + output schema — every tool now advertises an
- Jul 3, 2026
Fixed
- MCP Registry publish 403'd on namespace casing. The registry namespace derived from GitHub
OIDC is case-sensitive and matches the org's canonical login (
Atypical-Consulting), butserver.json'snameand the README ownership marker used lowercase (io.github.atypical-consulting/...), so the first publish wasForbidden. Corrected both toio.github.Atypical-Consulting/roseline-mcp. (The lowercase GHCR image name is unrelated and stays lowercase, as Docker requires.) - Docs
/releasespage didn't refresh on new releases. Therelease:trigger ondeploy-docs.ymlnever fired because the release is created by the publish workflow'sGITHUB_TOKEN, and GitHub does not start workflows from token-created events. Switched to aworkflow_runtrigger on thePublish NuGetworkflow's completion, which keys off the workflow (whose original trigger was a human tag push) and fires regardless of the publish outcome.
- MCP Registry publish 403'd on namespace casing. The registry namespace derived from GitHub
OIDC is case-sensitive and matches the org's canonical login (
- Jul 3, 2026
Documentation
- Docs site: a Releases page generated from GitHub Releases at build time (notes rendered from
each release, plus direct
.mcpb/.nupkgdownload buttons), a new Claude Desktop (1-click) install tab, and a note that RoselineMCP is listed in the official MCP Registry. The Astro build fetches the Releases API (authenticated in CI to avoid rate limits) and degrades to a GitHub link-out if the fetch fails.
Added
- One-click install for Claude Desktop (MCPB bundle). A
mcpb/manifest.json(MCPB spec 0.3) describes RoselineMCP as adnx-launched server; the release now builds and attaches aRoselineMCP.mcpbto each GitHub Release, so users can install with a dialog instead of editing JSON config. The bundle only wraps thednx RoselineMCPlaunch (the .NET 10 SDK is still required, since analysis loads projects through MSBuild), so it stays tiny and platform-agnostic. - Automated MCP Registry publishing.
publish-nuget.ymlnow has apublish-registryjob that, after a successful NuGet publish, waits for the version to index, then authenticates via GitHub OIDC (mcp-publisher login github-oidc, no secret) and publishes.mcp/server.jsonto the official registry (registry.modelcontextprotocol.io) — so the server is discoverable by any client/aggregator that reads the registry. Ownership is proven by anmcp-name:marker added to the packedREADME.md, which the registry cross-checks against the NuGet package. The manifest$schemawas migrated from the deprecated2025-10-17to the current2025-12-11(a URL-only change; the format is unchanged for stdio package servers). Takes effect on the next tagged release.
Security
- Pinned
Microsoft.Bcl.Memoryto10.0.9(aligned with thenet10.0TFM) inRoselineMCP.TokenBenchmarkto override the9.0.4thatMicrosoft.ML.Tokenizers2.0.0pulled in transitively, which was vulnerable to CVE-2026-26127 (GHSA-73j8-2gch-69rq, high severity — Base64Url out-of-bounds-read DoS). The benchmark harness is never packaged and is not referenced by the shippedRoselineMCPpackage, so published users were never exposed; this clears theNU1903restore warning. Remove the pin onceMicrosoft.ML.Tokenizersreferences a patched build.
- Docs site: a Releases page generated from GitHub Releases at build time (notes rendered from
each release, plus direct
- Jul 3, 2026
Changed
publish-nuget.ymlnow creates a GitHub Release and verifies the artifact before publishing. A git tag is not a GitHub Release, and nothing was creating one — so tagged versions published to NuGet without a corresponding Release (v1.3.0had to be backfilled by hand). The release job now: (1) fails the build if the packed.nupkgis missing.mcp/server.jsonor its embedded version doesn't match the tag — a guard that would have caught the originaldnx-fetches-1.0.0bug at the source rather than in the wild; and (2) after a successful NuGet push, creates (or heals) the matching GitHub Release with notes extracted from this CHANGELOG and the.nupkgattached.
Dependencies
Microsoft.ML.TokenizersandMicrosoft.ML.Tokenizers.Data.Cl100kBase1.0.3→2.0.0(RoselineMCP.TokenBenchmarkonly — not part of the shipped package) (#76)- Website:
astro5.x→7.0.0(#77) and CI Node20→24(#75) actions/upload-pages-artifactaction4→5(#74)
- Jul 3, 2026
v1.3.0 — Code navigation & editing tools
[1.3.0] - 2026-07-03
Added
- Token-efficient code navigation tools — six new read-only MCP tools that let an AI agent
retrieve precise structural/semantic information via Roslyn instead of reading whole files
(source code typically dominates an agent's token budget):
search_symbols— find symbols by wildcard/substring name pattern, or outline a single fileget_symbol_info— a symbol's kind, accessibility, modifiers, signature, base types, interfaces, XML docs, and definition location (optionally its source) — the compact "go to definition" payloadfind_references— every use site of a symbol across the solution, as location + snippetfind_implementations— implementations of an interface/member, overrides, or derived typesget_call_graph— a depth-bounded caller/callee graph with cycle detectionget_type_hierarchy— a type's base-class chain, interfaces, and derived types
- Surgical code-editing tools — two new write tools that emit a member-level change (not a
whole-file rewrite), keeping the tokens an agent produces proportional to the change. Both
default to preview mode (
previewOnly: true) likeApplyFixes, so nothing is written to disk unless the caller passespreviewOnly: falseexplicitly:edit_member— replace, add, or delete a single type memberrename_symbol— rename a symbol and update every reference across the solution (Roslyn rename)
IProjectLoader/ProjectLoaderservice that loads a project — and its containing solution when present, so references and renames span projects — into a fresh workspace per call, plusICodeNavigationServiceandICodeEditServiceand their response models.- Token-savings benchmark (
RoselineMCP.TokenBenchmark) — a reproducible harness that runs the real services against RoselineMCP's own source and measures each tool's output against the source an agent would otherwise read, tokenized with cl100k_base. Systematic sweeps; results stamped with commit + date. Reproduce withdotnet run --project RoselineMCP.TokenBenchmark -c Release. - Documentation site (
website/, Astro) with an overview, the tool reference, and the honest benchmark (charts + methodology + limitations), deployed to GitHub Pages via.github/workflows/deploy-docs.yml. Across 477 navigation tasks the read-only tools showed a pooled 81% / median 74% token reduction versus reading the corresponding files.
Changed
search_symbolsfile outline is now token-lean. The benchmark caught the outline costing tokens (it repeated the file path and fully-qualified name on every symbol); it now returns a lean projection (name, kind, signature, line), flipping its median from −45% to +30%.SymbolSummaryalso omits null fields from its JSON. Project-wide search is unchanged.
Fixed
dnx-based installs pulled an ancient1.0.0..mcp/server.jsonhardcodedversion/packages[0].versionat1.0.0— a version that was never released (releases start at1.2.0) — so any client resolving the MCP manifest was told to fetch1.0.0. Worse, despitePackageType=McpServerthe manifest was never packed into the.nupkg(it lives at the repo root with no<None Include>wiring it in), so the McpServer package shipped without its own manifest. Fixed by: (1) correcting the manifest to the current release, (2) packing../.mcp/server.jsoninto the package at.mcp/server.json, and (3) stamping the version into the manifest from the release tag inpublish-nuget.yml(mirroringMinVerVersionOverride) so it can never drift out of lockstep with the package version again.
- Token-efficient code navigation tools — six new read-only MCP tools that let an AI agent
retrieve precise structural/semantic information via Roslyn instead of reading whole files
(source code typically dominates an agent's token budget):
- Jul 2, 2026
v1.2.1 — Reference-project hardening
First real published release of RoselineMCP: reference-project hardening covering security defaults, real Git-URL analysis, correctness fixes, CI/CD, packaging, and a full documentation accuracy pass. See CHANGELOG.md for the itemized [1.2.0]/[1.2.1] entries.
Install
dotnet tool install -g RoselineMCPOr via Docker:
docker pull phmatray/roseline-mcp:1.2.1Note on versioning
v1.2.0's tag push published Docker Hub/GHCR images successfully but hit a CI bug that blocked the NuGet.org publish (fixed in this release — see CHANGELOG).v1.2.1republishes identical application content to both registries and is NuGet.org's first successful release.