Skip to content

CHANGELOG.md

Latest commit

 

History

History
179 lines (130 loc) · 9.49 KB

CHANGELOG.md

File metadata and controls

179 lines (130 loc) · 9.49 KB

Changelog

All notable changes to the .NET MCP Server will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

[1.1.2] - 2026-03-17

Fixed

  • ObjectDisposedException on all tool calls — MCP SDK v1.1.0's ExecuteToolAsTaskAsync disposes the request-scoped IServiceProvider before the background task resolves services (csharp-sdk#1430). Disabled InMemoryMcpTaskStore registration as a workaround; ToolTaskSupport.Optional attribute is preserved for re-enablement when the upstream fix ships.
  • Server reported hardcoded version 1.0.0 instead of the actual build version. Now reads from AssemblyInformationalVersionAttribute (set by MinVer).

Changed

  • asyncTasks capability now reports false until the upstream SDK bug is resolved (tracking issue #410).

[1.1.1] - 2026-03-17

Fixed

  • Task-mode tool calls (MCP SDK v1.1.0 ToolTaskSupport.Optional) failed with opaque "unknown error" when tools threw unhandled exceptions. Added resilient error-handling filter that catches exceptions and returns structured CallToolResult { IsError = true } instead.
  • Progress channel failures could crash tool execution when the client does not support progress notifications. Added defensive ReportProgressSafe() wrapper.

Added

  • Task lifecycle conformance tests (CallToolAsTaskAsync → GetTaskResultAsync → GetTaskAsync) to prevent regressions.

[1.1.0] - 2026-03-17

Changed

  • Updated ModelContextProtocol SDK dependency from v1.0.0 to v1.1.0.
  • Renamed and updated doc/sdk-v1.0-compatibility.md → doc/sdk-v1.1-compatibility.md to cover the v1.1 audit and task-related adoption.
  • Added an MCP feature usage table to README.md covering resources, prompts, roots, sampling, elicitation, progress, tasks, completion, and tool metadata.
  • Refreshed MCP SDK version references in doc/telemetry.md and doc/icons.md for the v1.1 update.
  • Updated ModelContextProtocol SDK dependency from v1.0.0-rc.1 to v1.0.0.
  • Updated MCP protocol version string from "0.5.0-preview.1" to "2025-11-25" (spec date format).
  • Renamed and updated doc/sdk-v0.6-compatibility.md → doc/sdk-v1.0-compatibility.md to cover v0.7–v1.0 changes.
  • Updated SDK version references in README.md, doc/telemetry.md, doc/icons.md, and .github/copilot-instructions.md.

1.0.0-beta.2 - 2026-01-12

Added

  • Two tiers of scenario tests
    • Fast MCP scenarios running as part of CI
    • Release-gate (long-running) scenarios runnable on-demand via workflow dispatch

Changed

  • Performance smoke tests are non-blocking in CI.
  • Path handling: replace Path.Combine usages with Path.Join.

Fixed

  • Template tooling reliability and CI flakiness
    • dotnet_sdk template listing fallback via dotnet new list
    • Template validation fallback when Template Engine API returns empty
    • Sanitize dotnet new CLI output to avoid spurious Error: text
  • CLI diagnostic parsing: deduplicate parsed diagnostics.
  • dotnet_project Test action behavior on .NET 10.
  • CI and scenario infrastructure: workflow hardening, cleanup/resource leak fixes, and more scenarios.

Security

  • CodeQL findings in TemplateEngineHelper.

1.0.0-beta.1 - 2026-01-10

Added

  • Consolidated tool surface (domain tools + utility tools) for better AI orchestration.
  • Machine-readable JSON output and contract/compliance improvements (MCP v0.5 metadata + error codes alignment).
  • Enhanced error diagnostics (CS/MSB/NU/NETSDK) with actionable guidance and documentation links.
  • SDK integration upgrades (Template Engine + MSBuild project analysis) and read-only resources for fast environment discovery.
  • Caching + concurrency improvements (TimeProvider-driven determinism, reduced lock contention, safer disposal behavior).
  • CI/CD hardening: MinVer-based NuGet publishing, separate MCP registry publishing workflow with retry, CodeQL + Codecov.
  • Expanded test coverage including conformance tests, performance smoke tests, and opt-in interactive tests.

Changed

  • Breaking: callers relying on legacy per-command MCP tool names must migrate to consolidated tool names.

1.0.0 - 2026-01-09

Added

  • Consolidated Tool Interface: 10 consolidated MCP tools (8 domain tools + 2 utilities) providing comprehensive .NET SDK functionality

    • dotnet_project - Project lifecycle management (New, Restore, Build, Run, Test, Publish, Clean, Analyze, Dependencies, Validate, Pack, Watch, Format)
    • dotnet_package - NuGet package and reference management (Add, Remove, Search, Update, List, AddReference, RemoveReference, ListReferences, ClearCache)
    • dotnet_solution - Solution file management (Create, Add, List, Remove)
    • dotnet_ef - Entity Framework Core operations (MigrationsAdd, MigrationsList, MigrationsRemove, MigrationsScript, DatabaseUpdate, DatabaseDrop, DbContextList, DbContextInfo, DbContextScaffold)
    • dotnet_workload - Workload management (List, Info, Search, Install, Update, Uninstall)
    • dotnet_tool - .NET tool management (Install, List, Update, Uninstall, Restore, CreateManifest, Search, Run)
    • dotnet_dev_certs - Developer certificates and secrets (CertificateTrust, CertificateCheck, CertificateClean, CertificateExport, SecretsInit, SecretsSet, SecretsList, SecretsRemove, SecretsClear)
    • dotnet_sdk - SDK and template information (Version, Info, ListSdks, ListRuntimes, ListTemplates, SearchTemplates, TemplateInfo, ClearTemplateCache, FrameworkInfo, CacheMetrics)
    • dotnet_help - Get help for any dotnet command
    • dotnet_server_capabilities - Get MCP server capabilities and concurrency guidance

  • MCP Resources: Read-only resources for efficient metadata access

    • dotnet://sdk-info - Installed .NET SDKs (versions and paths)
    • dotnet://runtime-info - Installed .NET runtimes (versions and types)
    • dotnet://templates - Complete catalog of installed .NET templates with metadata
    • dotnet://frameworks - Supported .NET frameworks (TFMs) including LTS status

  • SDK Integration: Direct integration with official .NET SDK packages

    • Microsoft.TemplateEngine.* (v10.0.101) for template metadata and validation
    • Microsoft.Build.* (v18.0.2) for project analysis and framework validation
    • Type-safe constants for frameworks, configurations, runtime identifiers, and common packages

  • Enhanced Error Diagnostics: Enriched error messages with explanations, documentation links, and suggested fixes

    • Support for 52 common error codes (CS####, MSB####, NU####, NETSDK####)
    • Plain English explanations with actionable guidance
    • Direct links to official Microsoft documentation

  • Secret Redaction: Automatic redaction of sensitive information in CLI output

    • Connection strings, passwords, API keys, and tokens automatically masked
    • Optimized implementation with <1% performance overhead
    • Opt-out available with unsafeOutput=true for advanced debugging

  • Machine-Readable Output: Optional JSON output for all tools via machineReadable parameter

    • Structured success and error responses
    • Consistent schema across all tools
    • Enhanced diagnostics in error responses

  • Caching Infrastructure: Intelligent caching for template and framework metadata

    • Reduces repeated SDK queries
    • Configurable TTL and cache metrics
    • Force reload option for fresh data

  • Concurrency Safety: Thread-safe implementation with concurrency guidance

    • Safe parallel execution of independent operations
    • Concurrency manager for resource protection
    • Documentation of concurrency patterns for AI orchestrators

  • Comprehensive Testing: 936 tests covering all functionality

    • MCP protocol conformance tests
    • Unit tests with code coverage (Cobertura format)
    • Integration tests for SDK interactions
    • Performance smoke tests

Documentation

  • Complete README with installation instructions for VS Code, Visual Studio, and Claude Desktop
  • AI Assistant Best Practices Guide with workflows and examples
  • Tool Surface Consolidation documentation (design rationale and architecture)
  • Machine-Readable JSON Contract specification (v1.0)
  • SDK Integration technical details
  • Error Diagnostics reference
  • Concurrency and performance documentation
  • Testing guide including opt-in interactive tests

Infrastructure

  • GitHub Actions CI/CD pipeline (build, test, coverage)
  • CodeQL security scanning
  • Automated NuGet package publishing
  • MCP Registry publishing workflow
  • MinVer-based automatic versioning from Git tags
  • Dependabot for dependency updates

Notes

  • MCP Server Only: This package is designed exclusively as an MCP server for AI assistants. It is not intended for use as a library or for programmatic consumption in other .NET applications.
  • Consolidated Tools: The server uses consolidated tools from day one (v1.0.0), providing better AI orchestration and maintainability compared to individual tools for each operation.
  • Target Framework: .NET 10.0 (LTS)
  • MCP SDK: ModelContextProtocol v0.5.0-preview.1
  • License: MIT