msbuild-mcp-server

zenoengine/msbuild-mcp-server

3.1

If you are the rightful owner of msbuild-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A lightweight MCP server for automating MSBuild projects and solutions builds.

MSBuild MCP Server

A lightweight MCP (Model Context Protocol) server for automating MSBuild projects and solutions builds. It dynamically locates MSBuild and provides 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 level, parallel build CPU count, NuGet restore, and additional command-line arguments through LLM-driven tool invocation.
  • Clear Error Reporting: Filters and presents concise, relevant error messages upon build failures.
  • MCP Client Compatibility: Supports seamless integration with popular MCP clients such as VSCode, Cursor, Windsurf, and more. Configuration snippets for these clients are provided in the documentation.
  • Cross-Language Support: Supports MSBuild-compatible projects, including .sln, .csproj, and .vcxproj files, enabling builds for languages like C#, C++, and more across Windows platforms.

Prerequisites

Ensure the following prerequisites are installed:

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

Registering the MCP Server

Ensure uv is installed.

In the MCP settings of your AI tools (e.g., Cursor, Windsurf, Claude Desktop, etc.), add the following configuration:

{
  "mcpServers": {
    "msbuild-mcp-server": {
      "command": "uvx",
      "args": [
        "msbuild-mcp-server@latest"
      ]
    }
  }
}

Place this snippet in your client configuration file:

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

Restart your tool to ensure that the msbuild-mcp-server and its provided tools are properly registered.

Agent Prompt Examples

AI agents can trigger builds using natural language like:

  • Basic Project Build

    "Build this solution at C:/Path/To/Project.sln using Release|x64."

  • Unreal Engine Build

    "Build the solution located at C:/Projects/MyGame/MyGame.sln using Development Editor|Win64."

License

This project is licensed under the MIT License.