返回 MCP 目录
public公开dns本地运行

msbuild-mcp-server

一个轻量级的MCP服务器,用于自动化MSBuild项目和解决方案的构建,支持动态发现MSBuild并提供可定制的构建配置选项。

article

README

🚀 MSBuild MCP 服务器

MSBuild MCP 服务器是一个轻量级的 MCP(模型上下文协议)服务器,可用于自动化 MSBuild 项目和解决方案的构建。它借助 vswhere Python 包动态定位 MSBuild,还提供了可自定义的构建配置选项,极大提升了构建的灵活性和效率。

🚀 快速开始

在使用 MSBuild MCP 服务器之前,需要确保安装了以下先决条件:

  • Python 3.11 或更高版本
  • Visual Studio 或 Visual Studio Build Tools(用于 MSBuild)
  • uv(推荐)

✨ 主要特性

  • 动态 MSBuild 发现:自动检测 MSBuild 可执行文件,确保与各种 Visual Studio 安装兼容。
  • 可自定义构建设置:轻松配置构建选项,如配置、平台、详细程度、并行构建 CPU 数量、NuGet 恢复和额外命令行参数。
  • 清晰的错误报告:过滤并呈现简洁的相关错误信息,以便在构建失败时快速诊断问题。
  • MCP 客户端兼容性:与 MCP 客户端无缝集成,包括 VSCode、Cursor、Windsurf 等。
  • 跨语言支持:适用于 MSBuild 兼容的项目(.sln、.csproj、.vcxproj)。

💻 使用示例

MCP 客户端设置

使用相同的配置片段在所有 MCP 客户端中:

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

将此片段放置在客户端配置文件中:

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

📄 许可证

本项目采用 MIT 许可证授权。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端