Msbuild Graph MCP

MSBuild项目图MCP服务器

    

LLM驱动的编码助手的MSBuild解决方案的预构建静态分析。 在构建之前，通过自然语言分析项目依赖关系、检测构建问题、检查共享导入和比较配置。

没有现有的MCP服务器提供预构建项目图分析。这填补了这一空白。

它的作用

问你的人工智能助手关于你的自然问题。NET/C++解决方案：

• *“显示此解决方案的依赖关系图”* → 具有拓扑排序的完整DAG
• *“是否存在TFM不匹配？”* → 查找引用net8.0库的net6.0项目
• *“Directory.Build.props会影响什么？”* → 显示导入每个共享文件的所有项目
• *“比较调试与发布”* → 物业和套餐参考差异
• *“LangVersion是从哪里来的？”* → 目录跟踪。Build.props第3行

工具

支持的客户

✅ 适用于

❌ 不支持

快速开始

安装

dotnet tool install -g MsBuildGraphMcp

配置

克劳德桌面 --添加到 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "msbuild-graph": {
      "command": "msbuild-graph-mcp"
    }
  }
}

克劳德代码：

claude mcp add msbuild-graph -- msbuild-graph-mcp

VS Code --添加到 .vscode/mcp.json:

{
  "servers": {
    "msbuild-graph": {
      "type": "stdio",
      "command": "msbuild-graph-mcp"
    }
  }
}

光标 --添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "msbuild-graph": {
      "command": "msbuild-graph-mcp"
    }
  }
}

需求

• .NET SDK 8.0+（或Visual Studio 2022+）
• Windows（MSBuildLocator发现VS/.NET SDK安装）

输出示例

get_project_graph

{
  "metrics": {
    "nodeCount": 4,
    "edgeCount": 3,
    "uniqueProjectCount": 4,
    "maxDepth": 2,
    "constructionTimeMs": 297
  },
  "projects": [
    {
      "name": "WebApp",
      "targetFrameworks": ["net8.0"],
      "outputType": "Exe",
      "isRoot": true,
      "references": ["DataLib\\DataLib.csproj", "CoreLib\\CoreLib.csproj"]
    }
  ],
  "topologicalOrder": [
    "CoreLib\\CoreLib.csproj",
    "DataLib\\DataLib.csproj",
    "WebApp\\WebApp.csproj"
  ]
}

detect_build_issues

{
  "totalIssues": 2,
  "frameworkMismatches": [{
    "project": "OldApp.csproj",
    "projectTfm": "net6.0",
    "dependency": "NewLib.csproj",
    "dependencyTfm": "net8.0",
    "reason": "net6.0 cannot consume net8.0"
  }],
  "orphanProjects": [{
    "name": "UnusedLib",
    "reason": "Library with no referencing projects"
  }]
}

特性

• 预构建分析 --无需生成，直接评估MSBuild项目文件
• .sln/.slnx/.slnf --支持所有解决方案格式，包括新的.slnx（VS 17.10+）
• 多目标识别 --通过外部/内部构建重复数据删除正确处理TargetFrameworks（复数）
• TFM兼容性 --NuGet。基于框架的检查（net8.0-windows与net8.0、netstandard2.0与net48等）
• 财产来源追踪 --显示定义每个MSBuild属性的文件和行号
• 配置差异 --比较任意两种配置（调试/发布、自定义配置）
• 循环依赖检测 --捕获MSB4251和循环依赖异常
• 共享导入发现 --标识目录。Build.props，目录。构建目标，目录。包装.props
• CPM检测 --识别中央包管理（ManagePack VersionsCentrally）

安全

所有工具都是 只读 --不会触发任何构建，也不会修改任何文件。

重要提示： MSBuild属性函数在评估期间执行（按设计）。功能如下 $([System.IO.File]::ReadAllText(...)) 加载项目时运行。只分析你信任的项目。

建筑

┌──────────────────┐     stdio (JSON-RPC)   ┌─────────────────────┐
│ Claude / Copilot │◄──────────────────────►│ msbuild-graph-mcp   │
│ VS Code / Cursor │                        │                     │
└──────────────────┘                        │ MSBuildLocator      │
                                            │ ► ProjectGraph      │
                                            │ ► ProjectCollection │
                                            │ ► SolutionPersist   │
                                            └─────────────────────┘

关键架构决策：

• MSBuildLocator JIT陷阱模式 --Main（）中的RegisterInstance（），MSBuild类型仅在\[NoInline\]方法中
• 评估背景。共享 通过ProjectInstanceFactoryFunc--大型解决方案的2-5倍加速
• 平行度上限为8 --防止高核心计算机上的内存耗尽
• 微软。版本17.13.9 使用ExcludeAssets=“runtime”--避免17.14.8依赖项发布错误

测试

35个测试文件中的333个测试，来自5轮互联网研究，涵盖20多个来源：

dotnet test tests/MsBuildGraphMcp.Tests/
# Passed! - Failed: 0, Passed: 333, Skipped: 0, Total: 333, Duration: 12s

测试类别：验证、核心工具、TFM兼容性、安全性（OWASP/CVE）、解决方案格式、生产弹性、并发性、路径边缘情况、JSON序列化、真实场景。

在测试过程中发现并修复了8个生产错误。

补充工具

此服务器提供 预生成 分析。对于 后期生成 分析（需要完整的构建），请参阅：

• BinlogInsights。模型上下文协议(Model Context Protocol) --26个MCP工具+13个CLI命令，用于MSBuild二进制日志分析（构建时间、错误、性能、分析器）
• baronel/mcp binlog工具 --MSBuild二进制日志分析（生成时间、错误、目标）

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院 -弗洛林·维卡