msbuild-mcp-server 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

msbuild_mcp_server/server.py

@@ -2,6 +2,10 @@ import subprocess
 import os
 from fastmcp import FastMCP
 from vswhere import get_latest_path
+import xml.etree.ElementTree as ET
+import json
+from typing import Annotated
+from pydantic import Field
 
 # Create MCP server instance
 mcp = FastMCP("MSBuild MCP Server")
@@ -23,40 +27,112 @@ def find_msbuild():
 
     return msbuild_path
 
-@mcp.tool()
+
+def get_msbuild_configurations_and_platforms(project_path: str):
+    """
+    Extract available configurations and platforms from a given MSBuild project or solution file.
+    Returns (configurations, platforms) as lists.
+    """
+    configs = set()
+    plats = set()
+    if project_path.endswith('.sln'):
+        # Parse .sln file as text directly
+        with open(project_path, encoding='utf-8') as f:
+            for line in f:
+                if 'GlobalSection(SolutionConfigurationPlatforms)' in line:
+                    for config_line in f:
+                        if 'EndGlobalSection' in config_line:
+                            break
+                        if '=' in config_line:
+                            configplat = config_line.split('=')[0].strip()
+                            if '|' in configplat:
+                                config, plat = configplat.split('|', 1)
+                                configs.add(config)
+                                plats.add(plat)
+    else:
+        # Parse .csproj/.vcxproj files as XML
+        try:
+            tree = ET.parse(project_path)
+            root = tree.getroot()
+            ns = {'msbuild': 'http://schemas.microsoft.com/developer/msbuild/2003'}
+            for pg in root.findall('.//msbuild:PropertyGroup', ns):
+                cond = pg.attrib.get('Condition', '')
+                if 'Configuration' in cond and 'Platform' in cond:
+                    # Example: ' '$(Configuration)|$(Platform)' == 'Debug|x64' '
+                    import re
+                    m = re.search(r"'\$\(Configuration\)\|\$\(Platform\)'\s*==\s*'([^|]+)\|([^']+)'", cond)
+                    if m:
+                        configs.add(m.group(1))
+                        plats.add(m.group(2))
+        except Exception:
+            pass
+    return list(configs), list(plats)
+
+
+@mcp.tool(
+    name="build_msbuild_project",
+    description="Build an MSBuild project or solution (.sln, .csproj, .vcxproj) file using MSBuild.",
+    tags={"msbuild", "build", "visualstudio"}
+)
 def build_msbuild_project(
-    project_path: str,
-    configuration: str = "Debug",
-    platform: str = "x64",
-    verbosity: str = "minimal",
-    max_cpu_count: int = None,
-    restore: bool = True,
-    additional_args: str = ""
+    project_path: Annotated[str, Field(description="Absolute path to the project or solution file to build.")],
+    configuration: Annotated[str, Field(description="Build configuration (e.g., Debug, Release).")],
+    platform: Annotated[str, Field(description="Target platform (e.g., x86, x64).")],
+    verbosity: Annotated[str, Field(description="MSBuild output verbosity (quiet, minimal, normal, detailed, diagnostic).")]="minimal",
+    max_cpu_count: Annotated[int, Field(description="Maximum number of CPUs for parallel build (default: None, uses automatic parallel build).")]=None,
+    restore: Annotated[bool, Field(description="Whether to perform NuGet restore before build. Default is True.")]=True,
+    additional_args: Annotated[str, Field(description="Additional MSBuild command-line arguments (as a string, separated by spaces).")]=""
 ) -> str:
     """
-    Build an MSBuild project or solution (.sln, .csproj, .vcxproj) file using MSBuild.
-
-    This tool dynamically locates the MSBuild executable using the vswhere Python package.
-    It supports flexible build configurations, including verbosity, platform, and additional arguments.
+    Build an MSBuild project or solution (.sln, .csproj, .vcxproj) file using MSBuild
 
     Parameters:
-    - project_path: Path to the project or solution file to build.
-    - configuration: Build configuration (e.g., Debug, Release).
-    - platform: Target platform (e.g., x86, x64).
-    - verbosity: MSBuild output verbosity (quiet, minimal, normal, detailed, diagnostic).
-    - max_cpu_count: Maximum number of CPUs for parallel build (None for default).
-    - restore: Whether to perform NuGet restore before build.
-    - additional_args: Additional MSBuild command-line arguments.
+    - project_path: Absolute path to the project or solution file to build.
+    - configuration: Build configuration (e.g., Debug, Release). Default is "Debug".
+    - platform: Target platform (e.g., x86, x64). Default is "x64".
+    - verbosity: MSBuild output verbosity (quiet, minimal, normal, detailed, diagnostic). Default is "minimal".
+    - max_cpu_count: Maximum number of CPUs for parallel build (default: None, if not specified, uses automatic parallel build).
+    - restore: Whether to perform NuGet restore before build. Default is True.
+    - additional_args: Additional MSBuild command-line arguments (as a string, separated by spaces). Default is "".
 
     Returns:
     - A string indicating the build result, including success or filtered error messages.
 
-    Use this tool to automate the build process for MSBuild projects, ensuring compatibility with various configurations and environments.
+    This tool can be used to automate MSBuild project builds in various environments.
     """
     msbuild = find_msbuild()
+    
+    if not os.path.isfile(project_path):
+        return (
+            f"The specified project_path does not exist or is not a file: {project_path}\n"
+            "Please provide the absolute path to the project or solution file to build."
+        )
+
+    # If configuration or platform is not specified, return the available options
+    configs, plats = get_msbuild_configurations_and_platforms(project_path)
+    if not configuration or not platform:
+        if not configs or not plats:
+            return "Could not extract available configurations or platforms from the project file. Please specify them manually."
+        return json.dumps({
+            "message": "Please select a configuration and platform from the available options.",
+            "available_configurations": configs,
+            "available_platforms": plats
+        }, ensure_ascii=False)
+    # If the provided configuration or platform is not in the supported list, return a message
+    if configs and configuration not in configs:
+        return json.dumps({
+            "message": f"The configuration '{configuration}' is not supported by this project. Please select from the available options.",
+            "available_configurations": configs
+        }, ensure_ascii=False)
+    if plats and platform not in plats:
+        return json.dumps({
+            "message": f"The platform '{platform}' is not supported by this project. Please select from the available options.",
+            "available_platforms": plats
+        }, ensure_ascii=False)
+
     cmd = [
         msbuild,
-        project_path,  # Updated from sln_path to project_path
+        project_path,
         f"/p:Configuration={configuration}",
         f"/p:Platform={platform}",
         f"/verbosity:{verbosity}"

{msbuild_mcp_server-0.1.0.dist-info → msbuild_mcp_server-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: msbuild-mcp-server
-Version: 0.1.0
+Version: 0.1.2
 Summary: A lightweight MCP server for automating MSBuild projects and solutions builds.
 License: MIT
 Requires-Python: >=3.11
@@ -9,20 +9,22 @@ License-File: LICENSE
 Requires-Dist: fastmcp>=2.0
 Requires-Dist: uv
 Requires-Dist: vswhere>=1.0.0
-Requires-Dist: pytest
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
 Dynamic: license-file
 
 # MSBuild MCP Server
 
-A lightweight MCP (Model Context Protocol) server for automating MSBuild projects and solutions builds. It dynamically locates MSBuild using the `vswhere` Python package and provides customizable build configuration options.
+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 using `vswhere`, 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.
+- **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**: Integrates seamlessly with MCP clients, including VSCode, Cursor, Windsurf, and more.
-- **Cross-Language Support**: Works with MSBuild-compatible projects (.sln, .csproj, .vcxproj).
+- **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
 
@@ -32,21 +34,19 @@ Ensure the following prerequisites are installed:
 - Visual Studio or Visual Studio Build Tools (for MSBuild)
 - [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (recommended)
 
-## MCP Client Setup
+## Registering the MCP Server
 
-Use the same configuration snippet for all MCP clients:
+Ensure `uv` is installed.
+
+In the MCP settings of your AI tools (e.g., Cursor, Windsurf, Claude Desktop, etc.), add the following configuration:
 
 ```json
 {
   "mcpServers": {
     "msbuild-mcp-server": {
-      "type": "stdio",
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "--directory",
-        "<path/to/cloned/msbuild-mcp-server>",
-        "run",
-        "src/msbuild_mcp_server/server.py"
+        "msbuild-mcp-server@latest"
       ]
     }
   }
@@ -58,6 +58,8 @@ Place this snippet in your client configuration file:
 - **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.
+
 ## License
 
 This project is licensed under the MIT License.

msbuild_mcp_server-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+msbuild_mcp_server/server.py,sha256=MLu76aJOVHZNqk0NbCOVEcCyVroou4SIUlIxHbZ9dBY,8132
+msbuild_mcp_server-0.1.2.dist-info/licenses/LICENSE,sha256=zEukTMUBlTMWO2Xlr5s53ZzahKcZVcpRSegfwDKuLs0,1091
+msbuild_mcp_server-0.1.2.dist-info/METADATA,sha256=sKVOf6t8K_BgKG0qJoZVh0rnLLEGZdFhRQ3xgxCIU40,2620
+msbuild_mcp_server-0.1.2.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+msbuild_mcp_server-0.1.2.dist-info/entry_points.txt,sha256=OWN3dxqf2u2KixCBqT_3sj8hDwaElUa0-J9uaC6z-K8,70
+msbuild_mcp_server-0.1.2.dist-info/top_level.txt,sha256=6gy0MqZpIjrsVTU2b8izs-i6dJiC_FbjfL4JE0IvV2I,19
+msbuild_mcp_server-0.1.2.dist-info/RECORD,,

{msbuild_mcp_server-0.1.0.dist-info → msbuild_mcp_server-0.1.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.1.0)
+Generator: setuptools (80.3.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

msbuild_mcp_server-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-msbuild_mcp_server/server.py,sha256=VwlfbLJ-AWjylxlI_fKvvvSPHP6xkmVOfZkJfBphcEo,3877
-msbuild_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=zEukTMUBlTMWO2Xlr5s53ZzahKcZVcpRSegfwDKuLs0,1091
-msbuild_mcp_server-0.1.0.dist-info/METADATA,sha256=aG7SyB29Ofr7n58usmYohyuwFMZXt9GSIAyfDf1Dhq4,2290
-msbuild_mcp_server-0.1.0.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
-msbuild_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=OWN3dxqf2u2KixCBqT_3sj8hDwaElUa0-J9uaC6z-K8,70
-msbuild_mcp_server-0.1.0.dist-info/top_level.txt,sha256=6gy0MqZpIjrsVTU2b8izs-i6dJiC_FbjfL4JE0IvV2I,19
-msbuild_mcp_server-0.1.0.dist-info/RECORD,,