Add MCP Server to expose Cast refactoring commands as standardized tools

[Copilot]

This PR implements a complete Model Context Protocol (MCP) Server that exposes all 61+ Cast refactoring commands as standardized tools for AI agents and other MCP clients.

What's Added

New MCP Server Project

• Cast.Tool.McpServer - New console application using the official ModelContextProtocol library
• Automatic discovery of all existing Cast commands via reflection
• JSON schema generation for each command's input parameters
• Production-ready hosting with Microsoft.Extensions.Hosting

Key Features

• Complete Tool Coverage: All Cast commands exposed as MCP tools with cast_ prefix:

  • cast_rename - Rename symbols at specified locations
  • cast_extract_method - Extract methods from code selections
  • cast_add_using - Add missing using statements
  • cast_convert_auto_property - Convert between auto and full properties
  • And 57+ more refactoring operations

• Proper MCP Protocol Support:

  • Handles list_tools requests to discover available commands
  • Processes call_tool requests to execute refactoring operations
  • Comprehensive error handling and validation

• Rich Parameter Schemas: Each tool includes detailed JSON schemas defining:

  • Required parameters (e.g., file_path, old_name/new_name for rename)
  • Optional parameters (e.g., line_number, column_number, dry_run)
  • Parameter descriptions and validation rules

Usage

Start the MCP server:

dotnet run --project Cast.Tool.McpServer/Cast.Tool.McpServer.csproj

The server listens on stdin/stdout using the MCP protocol. AI agents can then:

1. Discover tools via list_tools to see all 61+ available refactoring commands
2. Execute refactoring via call_tool with JSON parameters:

{
  "name": "cast_rename",
  "arguments": {
    "file_path": "MyClass.cs",
    "line_number": 15,
    "old_name": "oldVariableName", 
    "new_name": "newVariableName",
    "dry_run": true
  }
}

Architecture

• Zero Breaking Changes: Existing Cast CLI functionality unchanged
• Automatic Integration: New commands added to Cast automatically appear in MCP server
• Reuses Existing Logic: MCP server acts as protocol adapter over existing refactoring engine
• Production Ready: Full logging, error handling, and hosting infrastructure

Testing

• All existing tests continue to pass (73 → 75 tests)
• New MCP server tests verify proper initialization and command discovery
• Complete solution builds successfully with no warnings or errors

Documentation

• Updated main README with MCP server usage examples
• Comprehensive Cast.Tool.McpServer/README.md with full API documentation
• Command reference showing all available tools and their parameters

This enables AI agents to perform sophisticated C# code refactoring through a standardized interface while leveraging Cast's battle-tested Roslyn-based refactoring engine.

Fixes #6.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[AdamFrisby]

Try build this from the commands themselves, rather than duplicating this.

[AdamFrisby]

@copilot please continue until done (see review comments)

[Copilot]

@copilot please continue until done (see review comments)

Completed! I've eliminated the command description duplication by creating a shared CastCommandRegistry that serves as the single source of truth. Both the CLI and MCP server now use the same registry instead of duplicating 61+ command descriptions. Changes committed in 2e4cb12.