~/tools / MCP Config Checker
MCP Config Checker — 檢查 MCP 設定檔中的錯誤
檢查 MCP 伺服器設定檔(.mcp.json 或 claude_desktop_config.json)中的錯誤:缺少 type、頂層鍵名錯誤、保留或無效的名稱、相對路徑、未設定的變數,以及直接寫進檔案的機密。內容不會離開你的瀏覽器。
規則已於 2026-10-23 對照文件核對。
文件: Claude Code / Model Context Protocol / VS Code
未檢查:command 是否存在、套件是否能安裝、遠端伺服器是否有回應,以及其他應用程式讀取方式不同的設定。
所有處理都在你的瀏覽器中執行,設定不會被上傳。
MCP 伺服器是在 JSON 檔案中設定的,一個小錯誤就可能讓伺服器默默地沒有出現。有 url 但沒有 type 的伺服器項目會被略過,使用 VS Code 的 servers 鍵的檔案不會被 Claude Code 或 Claude Desktop 讀取,而未設定的環境變數會以純文字原樣傳下去。本工具會讀取你貼上的設定,列出文件指出行不通的部分、值得確認的部分,以及僅供參考的備註。當 token 看起來被直接寫進檔案時也會提出警告,因為這樣它可能被一併提交到版本控制。規則依據 Claude Code、Model Context Protocol 與 VS Code 的文件,並在工具下方顯示的日期進行過核對。
使用情境
- 找出編輯 .mcp.json 或 claude_desktop_config.json 之後,MCP 伺服器沒有出現的原因
- 把從 README 複製來的設定加入共用專案之前先檢查
- 在提交之前,找出寫進設定檔的 token 與密碼
使用方法
- 貼上你的 MCP 設定檔內容,或載入範例。
- 先看找到的伺服器及各自的種類,再看檢查結果的清單。修正表示文件指出該項目行不通,確認表示值得看一下,備註則僅供參考。
- 編輯檔案後再貼上一次,並重新啟動讀取該檔案的應用程式。
FAQ
它涵蓋哪些檔案與應用程式?
涵蓋 Claude Code 的專案檔 .mcp.json 與 Claude Desktop 的 claude_desktop_config.json 所使用的 mcpServers 格式。其他應用程式可能讀取不同的欄位或不同的頂層鍵,請查閱它們各自的文件。例如 VS Code 使用名為 servers 的頂層鍵。
我的項目有 url 但沒有 type,這有什麼問題?
Claude Code 會把沒有 type 的項目當作 stdio 伺服器讀取,因此有 url 但沒有 type 的項目屬於設定錯誤,該伺服器會被略過。請加上 type,值為 http、sse 或 ws。
像 ${API_KEY} 這樣未設定的變數會怎麼處理?
Claude Code 會展開 command、args、env、url 與 headers 中的 ${VAR} 與 ${VAR:-default}。如果變數未設定且沒有預設值,設定仍會載入,Claude Code 會顯示警告,並把 ${VAR} 當作原樣文字使用。在安全的情況下,請用 ${VAR:-default} 加上預設值。
為什麼它會警告檔案中有 token?
直接寫進設定檔的 token,可能在檔案被提交或傳給他人時一併外流。這項檢查是根據已知 token 格式,以及 api-key、token、password 等名稱所做的啟發式判斷,因此可能漏掉某個機密,也可能把無害的值標出來。使用 ${VAR} 可以讓該值不留在檔案中。
它會啟動伺服器或測試連線嗎?
不會。它只讀取文字。它無法得知某個 command 是否存在、套件能否安裝,或遠端伺服器是否連得上,所以檔案通過檢查之後,請在應用程式中測試該伺服器。
我的設定會被傳送到伺服器嗎?
不會。檢查是在你的瀏覽器中執行的。