|
13 | 13 | logger = get_logger('AI Guardrails Claude Config') |
14 | 14 |
|
15 | 15 | _CLAUDE_CONFIG_PATH = Path.home() / '.claude.json' |
| 16 | +_CLAUDE_SETTINGS_PATH = Path.home() / '.claude' / 'settings.json' |
16 | 17 |
|
17 | 18 |
|
18 | 19 | def load_claude_config(config_path: Optional[Path] = None) -> Optional[dict]: |
@@ -42,3 +43,117 @@ def get_user_email(config: dict) -> Optional[str]: |
42 | 43 | Reads oauthAccount.emailAddress from the config dict. |
43 | 44 | """ |
44 | 45 | return config.get('oauthAccount', {}).get('emailAddress') |
| 46 | + |
| 47 | + |
| 48 | +def get_mcp_servers(config: dict) -> Optional[dict]: |
| 49 | + """Extract MCP servers from Claude config. |
| 50 | +
|
| 51 | + Reads mcpServers from the config dict. |
| 52 | + """ |
| 53 | + return config.get('mcpServers') |
| 54 | + |
| 55 | + |
| 56 | +def load_claude_settings(settings_path: Optional[Path] = None) -> Optional[dict]: |
| 57 | + """Load and parse ~/.claude/settings.json. |
| 58 | +
|
| 59 | + Args: |
| 60 | + settings_path: Override path for testing. Defaults to ~/.claude/settings.json. |
| 61 | +
|
| 62 | + Returns: |
| 63 | + Parsed dict or None if file is missing or invalid. |
| 64 | + """ |
| 65 | + path = settings_path or _CLAUDE_SETTINGS_PATH |
| 66 | + if not path.exists(): |
| 67 | + logger.debug('Claude settings file not found', extra={'path': str(path)}) |
| 68 | + return None |
| 69 | + try: |
| 70 | + content = path.read_text(encoding='utf-8') |
| 71 | + return json.loads(content) |
| 72 | + except Exception as e: |
| 73 | + logger.debug('Failed to load Claude settings file', exc_info=e) |
| 74 | + return None |
| 75 | + |
| 76 | + |
| 77 | +def _resolve_marketplace_path(marketplace: dict) -> Optional[Path]: |
| 78 | + """ |
| 79 | + Resolve filesystem path for a directory-type marketplace. |
| 80 | + """ |
| 81 | + source = marketplace.get('source', {}) |
| 82 | + if source.get('source') != 'directory': |
| 83 | + return None |
| 84 | + raw = source.get('path') |
| 85 | + if not raw: |
| 86 | + return None |
| 87 | + path = Path(raw) |
| 88 | + return path if path.is_dir() else None |
| 89 | + |
| 90 | + |
| 91 | +def _load_plugin_json_file(plugin_path: Path, relative_path: str) -> Optional[dict]: |
| 92 | + """Load and parse a JSON file inside a plugin directory. |
| 93 | +
|
| 94 | + Returns None if the file is missing, unreadable, or has invalid JSON. |
| 95 | + """ |
| 96 | + target = plugin_path / relative_path |
| 97 | + if not target.exists(): |
| 98 | + return None |
| 99 | + try: |
| 100 | + return json.loads(target.read_text(encoding='utf-8')) |
| 101 | + except Exception as e: |
| 102 | + logger.debug('Failed to load plugin file', extra={'path': str(target)}, exc_info=e) |
| 103 | + return None |
| 104 | + |
| 105 | + |
| 106 | +def resolve_plugins(settings: dict) -> tuple[dict, dict]: |
| 107 | + """Resolve enabled plugins to their MCP servers and metadata. |
| 108 | +
|
| 109 | + Walks enabledPlugins from claude settings, resolves each plugin's 'marketplace' directory |
| 110 | + via the 'extraKnownMarketplaces' field, and reads: |
| 111 | + - <path>/.mcp.json for MCP servers (merged into a flat dict) |
| 112 | + - <path>/.claude-plugin/plugin.json for metadata (name, version, description) |
| 113 | +
|
| 114 | + Args: |
| 115 | + settings: Parsed ~/.claude/settings.json dict. |
| 116 | +
|
| 117 | + Returns: |
| 118 | + Tuple of (merged_mcp_servers, enriched_plugins): |
| 119 | + - merged_mcp_servers: {server_name: server_config, ...} |
| 120 | + - enriched_plugins: {plugin_key: {"enabled": True, "name": ..., ...}, ...} |
| 121 | + """ |
| 122 | + enabled = settings.get('enabledPlugins') or {} |
| 123 | + marketplaces = settings.get('extraKnownMarketplaces') or {} |
| 124 | + merged_mcp: dict = {} |
| 125 | + enriched: dict = {} |
| 126 | + |
| 127 | + for plugin_key, is_enabled in enabled.items(): |
| 128 | + if not is_enabled: |
| 129 | + continue |
| 130 | + |
| 131 | + entry: dict = {'enabled': True} |
| 132 | + enriched[plugin_key] = entry |
| 133 | + |
| 134 | + if '@' not in plugin_key: |
| 135 | + continue |
| 136 | + |
| 137 | + _plugin_name, marketplace_name = plugin_key.split('@', 1) |
| 138 | + marketplace = marketplaces.get(marketplace_name) |
| 139 | + if not marketplace: |
| 140 | + continue |
| 141 | + |
| 142 | + plugin_path = _resolve_marketplace_path(marketplace) |
| 143 | + if plugin_path is None: |
| 144 | + continue |
| 145 | + |
| 146 | + metadata = _load_plugin_json_file(plugin_path, '.claude-plugin/plugin.json') or {} |
| 147 | + for field in ('name', 'version', 'description'): |
| 148 | + if field in metadata: |
| 149 | + entry[field] = metadata[field] |
| 150 | + |
| 151 | + mcp_config = _load_plugin_json_file(plugin_path, '.mcp.json') or {} |
| 152 | + plugin_server_names = [] |
| 153 | + for server_name, server_cfg in (mcp_config.get('mcpServers') or {}).items(): |
| 154 | + merged_mcp[server_name] = server_cfg |
| 155 | + plugin_server_names.append(server_name) |
| 156 | + if plugin_server_names: |
| 157 | + entry['mcp_server_names'] = plugin_server_names |
| 158 | + |
| 159 | + return merged_mcp, enriched |
0 commit comments