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

msbuild_mcp_server/server.py

@@ -0,0 +1,102 @@
+import subprocess
+import os
+from fastmcp import FastMCP
+from vswhere import get_latest_path
+
+# Create MCP server instance
+mcp = FastMCP("MSBuild MCP Server")
+
+# Replace the find_msbuild function to use the vswhere Python package
+# and retrieve the latest MSBuild path dynamically.
+def find_msbuild():
+    """
+    Use the vswhere Python package to locate the MSBuild executable.
+    Returns the path to MSBuild if found, otherwise raises an exception.
+    """
+    msbuild_installation_path = get_latest_path(products='*')
+    if not msbuild_installation_path:
+        raise FileNotFoundError("MSBuild executable not found. Ensure Visual Studio is installed.")
+
+    msbuild_path = os.path.join(msbuild_installation_path, "MSBuild", "Current", "Bin", "MSBuild.exe")
+    if not os.path.exists(msbuild_path):
+        raise FileNotFoundError(f"MSBuild executable not found at expected path: {msbuild_path}")
+
+    return msbuild_path
+
+@mcp.tool()
+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 = ""
+) -> 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.
+
+    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.
+
+    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.
+    """
+    msbuild = find_msbuild()
+    cmd = [
+        msbuild,
+        project_path,  # Updated from sln_path to project_path
+        f"/p:Configuration={configuration}",
+        f"/p:Platform={platform}",
+        f"/verbosity:{verbosity}"
+    ]
+
+    if max_cpu_count:
+        cmd.append(f"/maxcpucount:{max_cpu_count}")
+    else:
+        cmd.append("/m")  # Default parallel build
+
+    if restore:
+        cmd.append("/restore")
+
+    if additional_args:
+        cmd.extend(additional_args.split())
+
+    try:
+        result = subprocess.run(
+            cmd,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,  # Capture stderr separately
+            text=True,
+            encoding="utf-8"
+        )
+
+
+        if result.returncode == 0:
+            return f"Build succeeded."
+        else:
+            # Filter error messages from both stdout and stderr
+            error_lines_stdout = [line for line in result.stdout.splitlines() if "error" in line.lower()]
+            error_lines_stderr = [line for line in result.stderr.splitlines() if "error" in line.lower()]
+            filtered_errors = "\n".join(error_lines_stdout + error_lines_stderr)
+            return f"Build failed with errors.\nFiltered Errors:\n{filtered_errors}\nFull Output:\n{result.stdout}\nErrors:\n{result.stderr}"
+    except FileNotFoundError:
+        return "MSBuild executable not found. Ensure MSBuild is installed and added to the PATH."
+
+def main():
+    """Entry point for the msbuild-mcp-server CLI."""
+    mcp.run()
+
+if __name__ == "__main__":
+    main()

msbuild_mcp_server-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: msbuild-mcp-server
+Version: 0.1.0
+Summary: A lightweight MCP server for automating MSBuild projects and solutions builds.
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: uv
+Requires-Dist: vswhere>=1.0.0
+Requires-Dist: pytest
+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.
+
+## 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.
+- **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).
+
+## Prerequisites
+
+Ensure the following prerequisites are installed:
+
+- Python 3.11 or higher
+- Visual Studio or Visual Studio Build Tools (for MSBuild)
+- [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (recommended)
+
+## MCP Client Setup
+
+Use the same configuration snippet for all MCP clients:
+
+```json
+{
+  "mcpServers": {
+    "msbuild-mcp-server": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "--directory",
+        "<path/to/cloned/msbuild-mcp-server>",
+        "run",
+        "src/msbuild_mcp_server/server.py"
+      ]
+    }
+  }
+}
+```
+
+Place this snippet in your client configuration file:
+- [**VSCode**](https://code.visualstudio.com/docs/copilot/chat/mcp-servers): `.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.
+

msbuild_mcp_server-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+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,,

msbuild_mcp_server-0.1.0.dist-info/WHEEL

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

msbuild_mcp_server-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+msbuild-mcp-server = msbuild_mcp_server.server:main

msbuild_mcp_server-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jin Hyung Ahn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

msbuild_mcp_server-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+msbuild_mcp_server