fix: move mcp_servers to metadata.json to prevent silent plugin.json rejection

Claude Code's strict schema validation silently rejects plugins with unknown
root-level fields in plugin.json (anthropics/claude-code#20409).
Moved mcp_servers to separate metadata.json files.
Updated install/uninstall/list scripts to read from new location.
Added cache clearing to switch-profile.sh.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-02-04 13:46:43 -05:00
parent 5a8c3b041f
commit de4126bf68
12 changed files with 26 additions and 14 deletions

View File

@@ -116,19 +116,19 @@ validate_target() {
}
# --- Get MCP Servers for Plugin ---
# Reads the mcp_servers array from plugin.json
# Reads the mcp_servers array from metadata.json (separate from plugin.json to avoid schema validation issues)
# Returns newline-separated list of MCP server names, or empty if none
get_mcp_servers() {
local plugin_name="$1"
local plugin_json="$REPO_ROOT/plugins/$plugin_name/.claude-plugin/plugin.json"
local metadata_json="$REPO_ROOT/plugins/$plugin_name/.claude-plugin/metadata.json"
if [[ ! -f "$plugin_json" ]]; then
if [[ ! -f "$metadata_json" ]]; then
return
fi
# Read mcp_servers array from plugin.json
# Read mcp_servers array from metadata.json
# Returns empty if field doesn't exist or is empty
jq -r '.mcp_servers // [] | .[]' "$plugin_json" 2>/dev/null || true
jq -r '.mcp_servers // [] | .[]' "$metadata_json" 2>/dev/null || true
}
# --- Check if plugin has any MCP servers ---