debug-mcp

debug-mcp 技能為除錯模型上下文協議 (MCP) 伺服器提供了一套結構化、命令列驅動的解決方案。該技能專為與 Microsoft Copilot Studio 協作的開發者設計，協助識別並解決常見的通訊問題，例如工具架構解析錯誤或因協議不匹配導致的執行失敗。透過 grep 進行靜態分析、手動驗證 JSON-RPC 以及經過驗證的檢查清單，確保您的 MCP 實作保持穩定、符合規範，並針對 AI 代理的使用進行了優化。

• 自動掃描潛在問題模式，例如會干擾 Copilot Studio 解析的選擇性參數、複雜型別 (Union, Optional, List, Dict) 及預設值。

• 包含系統化的驗證協議，用於測試伺服器連線、驗證工具架構註冊以及審核執行階段回應。

• 實作工具設計的最佳實踐，例如簡化複雜物件，並確保布林參數被顯式處理為字串。

• 直接整合專案文件與專家級除錯代理 (如 mcp-copilot-expert)，以應用已知修復方案。

• 當 Copilot Studio 無法正確呈現工具，或錯誤地顯示原始 JSON-RPC 參數時，請使用此技能。

• 適合需要將工具數量保持在建議的 70 個限制內，以在代理環境中獲得最佳效能的開發者。

• 確保所有工具定義都已分析 Python 實作與 MCP 規範之間可能存在的不匹配。

• 實務建議包括將多參數工具拆分為獨立函式以避開選擇性參數限制，並保持清晰的說明文件以提升模型可解釋性。

• 建議結合標準伺服器日誌使用，以便在開發週期的早期隔離啟動錯誤與連線問題。