MSBuild MCP Server

MSBuild MCP サーバー

MSBuild のプロジェクトやソリューションのビルドを自動化する、軽量な MCP（Model Context Protocol）サーバーです。MSBuild を動的に検出し、カスタマイズ可能なビルド設定を提供します。

特長

• MSBuild の動的検出：MSBuild 実行ファイルを自動的に検出し、さまざまな Visual Studio インストール環境との互換性を確保します。
• カスタマイズ可能なビルド設定：LLM 主導のツール呼び出しを通じて、構成、プラットフォーム、詳細レベル、並列ビルドの CPU 数、NuGet の復元、追加のコマンドライン引数などのビルドオプションを簡単に設定できます。
• 明確なエラー報告：ビルドに失敗した際に、簡潔で関連性の高いエラーメッセージを抽出して表示します。
• MCP クライアントとの互換性：VSCode、Cursor、Windsurf などの一般的な MCP クライアントとシームレスに連携できます。これらのクライアント用の設定例をドキュメントに記載しています。
• 複数言語のサポート：.sln、.csproj、.vcxproj ファイルなど、MSBuild 互換のプロジェクトをサポートし、Windows プラットフォーム上で C#、C++ などの言語のビルドを可能にします。

前提条件

以下がインストールされていることを確認してください。

• Python 3.11 以降
• Visual Studio または Visual Studio Build Tools（MSBuild 用）
• uv（推奨）

MCP サーバーの登録

uv がインストールされていることを確認してください。

AI ツール（Cursor、Windsurf、Claude Desktop など）の MCP 設定に、以下の設定を追加してください。

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

次のスニペットをクライアントの設定ファイルに配置してください。

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

msbuild-mcp-server とそのツールが正しく登録されるよう、ツールを再起動してください。

エージェントのプロンプト例

AI エージェントは、次のような自然言語でビルドを実行できます。

• 基本的なプロジェクトのビルド

  "C:/Path/To/Project.sln のソリューションを Release|x64 でビルドしてください。"

• Unreal Engine のビルド

  "C:/Projects/MyGame/MyGame.sln にあるソリューションを Development Editor|Win64 でビルドしてください。"

ライセンス

このプロジェクトは MIT License の下でライセンスされています。