Agent Skill 核验档案

Troubleshoot Binlog MCP

troubleshoot-binlog-mcp 是 dotnet/skills 仓库中 dotnet-msbuild 插件下的 Skill，用于诊断 dotnet-msbuild binlog MCP 服务器启动失败问题，例如 CONNECTION_CLOSED、binlog 服务器无法连接、缺少 binlog 工具、找不到 Microsoft.AITools.BinlogMcp、dnx 启动错误等。它诊断的是服务器启动本身，而非构建中记录的失败，不需要 binlog 文件或项目构建。

适用任务

诊断 binlog MCP 服务器启动失败，例如 CONNECTION_CLOSED 或 Microsoft.AITools.BinlogMcp 无法找到
检查工作区的 .NET SDK 选择（dotnet --info、dotnet --version）、global.json 与 NuGet 源配置（dotnet nuget list source）
复现宿主未修改的启动命令以捕获真实的启动错误（stdout、stderr 与退出码）
在包可用性不明时，用 dotnet package search 探测 Microsoft.AITools.BinlogMcp 的可用性
推荐策略安全的最小恢复方案，如让源所有者镜像该包到已批准的源、修复源的认证或证书配置
恢复后验证 MCP 初始化与工具列表（如 binlog_overview），并以 MCP status 行报告状态

输入

用户的错误信息（如 CONNECTION_CLOSED）
宿主的 MCP 状态或启动日志
宿主的实际 MCP 命令、参数与环境配置
工作区的 global.json 与 NuGet 配置（含父级/用户级、clear、禁用源、packageSourceMapping）

输出

观察到的失败原因（或仍未知部分）的脱敏证据报告
策略安全的最小恢复建议
一行 MCP 状态行（connected、failed 或 unverified）

限制与检查

只能诊断服务器启动，不能诊断 binlog 中记录的构建失败
按需运行，无法看到从未暴露给 agent 的宿主错误，不能注入会话启动上下文，也不能仅因插件安装而保证激活
不能在不改变诊断条件的前提下添加 --source、替换配置、移除 global.json、清缓存或安装另一副本
不适用于 binlog 内部错误、binlog 捕获或无关 MCP 服务器
未经用户批准不得编辑 NuGet 设置、宿主注册或 SDK 固定；不得在回答中泄露凭据、私有源 URL 或令牌
超时、静默或进程保持运行不能证明 MCP 已初始化
是否在将 CONNECTION_CLOSED 解读为包缺失前，先确认了实际失败的是服务器启动而非插件加载或宿主配置
是否从受影响的工作区、使用宿主的环境运行诊断，而不是从插件目录或 NuGet 设置不同的临时目录

Troubleshoot Binlog MCP

适用任务

输入

输出

限制与检查

搜索

项目详情