ASP.NET Core Debugging MCP Server 是一个MIT许可的MCP服务器，旨在让AI智能体（如Claude、Cursor等）能够直接调试.NET / ASP.NET Core应用程序。它基于netcoredbg构建，将调试适配器协议（DAP）的能力与面向智能体的复合工具相结合，使AI可以实际运行代码、暂停执行、读取运行时值、修改状态以测试修复，并基于真实观察结果给出回答，而非仅凭猜测。
主要能力方面，该服务器提供了27个工具，涵盖断点设置、单步执行、线程检查、异常分析、死锁分析以及请求追踪等。其中包含一些复合工具，如exception_autopsy、stack_explore、hang_analyze以及追踪工具，它们将多个DAP请求捆绑为单次工具调用，更便于智能体使用。此外，还提供自动插桩请求管线的能力，帮助定位慢请求的时间消耗。
使用方式上，安装只需三步：首先需要.NET 10 SDK，然后通过dotnet tool install -g AspNetCoreDebuggerMcp --prerelease安装（包内已捆绑linux-x64、linux-arm64、win-x64、osx-x64和osx-arm64的预构建netcoredbg，无需单独安装）。接着注册到Claude，可使用CLI命令claude mcp add aspnetcore-debugger -- aspnetcore-debugger-mcp，或编辑配置文件（.mcp.json、~/.claude.json或claude_desktop_config.json）添加如下内容：{ "mcpServers": { "aspnetcore-debugger": { "command": "aspnetcore-debugger-mcp" } } }。最后即可与Claude对话，通过/mcp确认连接，然后描述调试需求，智能体会自动选择合适工具。
适用场景包括：诊断EF Core查询返回空结果的原因、排查JWT认证返回401的问题、在不重启应用的情况下测试修复、分析应用挂起（如sync-over-async死锁）以及定位慢请求的时间消耗等。例如，智能体可以暂停在UserRepository.GetActiveAsync内读取EF Core实际发送的SQL，或断开JwtBearerHandler.HandleAuthenticateAsync检查认证处理程序看到的声明。
限制方面，需要主机安装.NET 10 SDK，且MCP服务器本身是一个跨平台.NET全局工具。已知限制还包括某些调试适配器和追踪的限制，具体文档中提及但未在此详述。此外，该项目是基于netcoredbg（MIT）和ModelContextProtocol SDK（MIT）构建的，与另一个debug-mcp项目相比，本项目是MIT许可且跨平台，而debug-mcp更深入运行时内部但仅限Linux且为AGPL。
