Msbuild MCP Server

🚀 MSBuild MCP Server

A lightweight MCP (Model Context Protocol) server for automating the build of MSBuild projects and solutions. It uses the vswhere Python package to dynamically locate MSBuild and offers customizable build configuration options.

✨ Features

• Dynamic MSBuild Discovery: Automatically detects the MSBuild executable, ensuring compatibility with various Visual Studio installations.
• Customizable Build Settings: Easily configure build options such as configuration, platform, verbosity, number of CPUs for parallel builds, NuGet restore, and additional command-line parameters.
• Clear Error Reporting: Filters and presents concise, relevant error information for quick issue diagnosis in case of build failures.
• MCP Client Compatibility: Seamlessly integrates with MCP clients, including VSCode, Cursor, Windsurf, etc.
• Cross - language Support: Suitable for MSBuild - compatible projects (.sln, .csproj, .vcxproj).

📦 Installation

Prerequisites

Ensure the following prerequisites are installed:

• Python 3.11 or higher
• Visual Studio or Visual Studio Build Tools (for MSBuild)
• uv (recommended)

💻 Usage Examples

MCP Client Setup

Use the same configuration snippet in all MCP clients:

{
  "mcpServers": {
    "msbuild-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/cloned/msbuild-mcp-server>",
        "run",
        "server.py"
      ]
    }
  }
}

Place this snippet in the client configuration files:

• VSCode: .vscode/mcp.json
• Cursor: ~/.cursor/mcp.json or <project-root>/.cursor/mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json

📄 License

This project is licensed under the MIT License.