mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-18 02:06:36 +00:00
0e71f29598
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm) - Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs) Major Changes: - Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration - Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation - Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.) - Added MCPDocsComponent for dynamic MCP documentation installation - Completely removed Hooks component (deleted hooks.py, updated all references) - Implemented two-stage interactive installation flow - Updated profiles and configuration files Benefits: - Much simpler and more reliable MCP configuration - Clear separation between server setup and documentation - Auto-selection of MCP docs based on server choices - User-friendly two-stage selection process 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
310 lines
12 KiB
Python
310 lines
12 KiB
Python
"""
|
|
MCP component for MCP server configuration via .claude.json
|
|
"""
|
|
|
|
import json
|
|
import shutil
|
|
from typing import Dict, List, Tuple, Optional, Any
|
|
from pathlib import Path
|
|
|
|
from ..base.component import Component
|
|
from ..utils.ui import display_info, display_warning
|
|
|
|
|
|
class MCPComponent(Component):
|
|
"""MCP servers configuration component"""
|
|
|
|
def __init__(self, install_dir: Optional[Path] = None):
|
|
"""Initialize MCP component"""
|
|
super().__init__(install_dir)
|
|
|
|
# Define MCP servers available for configuration
|
|
self.mcp_servers = {
|
|
"context7": {
|
|
"name": "context7",
|
|
"description": "Official library documentation and code examples",
|
|
"config_file": "context7.json",
|
|
"requires_api_key": False
|
|
},
|
|
"sequential": {
|
|
"name": "sequential-thinking",
|
|
"description": "Multi-step problem solving and systematic analysis",
|
|
"config_file": "sequential.json",
|
|
"requires_api_key": False
|
|
},
|
|
"magic": {
|
|
"name": "magic",
|
|
"description": "Modern UI component generation and design systems",
|
|
"config_file": "magic.json",
|
|
"requires_api_key": True,
|
|
"api_key_env": "TWENTYFIRST_API_KEY"
|
|
},
|
|
"playwright": {
|
|
"name": "playwright",
|
|
"description": "Cross-browser E2E testing and automation",
|
|
"config_file": "playwright.json",
|
|
"requires_api_key": False
|
|
},
|
|
"serena": {
|
|
"name": "serena",
|
|
"description": "Semantic code analysis and intelligent editing",
|
|
"config_file": "serena.json",
|
|
"requires_api_key": False
|
|
},
|
|
"morphllm": {
|
|
"name": "morphllm-fast-apply",
|
|
"description": "Fast Apply capability for context-aware code modifications",
|
|
"config_file": "morphllm.json",
|
|
"requires_api_key": True,
|
|
"api_key_env": "MORPH_API_KEY"
|
|
}
|
|
}
|
|
|
|
# This will be set during installation
|
|
self.selected_servers = []
|
|
|
|
def get_metadata(self) -> Dict[str, str]:
|
|
"""Get component metadata"""
|
|
return {
|
|
"name": "mcp",
|
|
"version": "4.0.0",
|
|
"description": "MCP server configuration management via .claude.json",
|
|
"category": "integration"
|
|
}
|
|
|
|
def set_selected_servers(self, selected_servers: List[str]) -> None:
|
|
"""Set which MCP servers were selected for configuration"""
|
|
self.selected_servers = selected_servers
|
|
self.logger.debug(f"MCP servers to configure: {selected_servers}")
|
|
|
|
def validate_prerequisites(self, installSubPath: Optional[Path] = None) -> Tuple[bool, List[str]]:
|
|
"""
|
|
Check prerequisites for MCP component
|
|
"""
|
|
errors = []
|
|
|
|
# Check if config source directory exists
|
|
source_dir = self._get_config_source_dir()
|
|
if not source_dir or not source_dir.exists():
|
|
errors.append(f"MCP config source directory not found: {source_dir}")
|
|
return False, errors
|
|
|
|
# Check if user's Claude config exists
|
|
claude_config = Path.home() / ".claude.json"
|
|
if not claude_config.exists():
|
|
errors.append(f"Claude configuration file not found: {claude_config}")
|
|
errors.append("Please run Claude Code at least once to create the configuration file")
|
|
|
|
return len(errors) == 0, errors
|
|
|
|
def get_files_to_install(self) -> List[Tuple[Path, Path]]:
|
|
"""MCP component doesn't install files - it modifies .claude.json"""
|
|
return []
|
|
|
|
def _get_config_source_dir(self) -> Optional[Path]:
|
|
"""Get source directory for MCP config files"""
|
|
project_root = Path(__file__).parent.parent.parent
|
|
config_dir = project_root / "SuperClaude" / "MCP" / "configs"
|
|
|
|
if not config_dir.exists():
|
|
return None
|
|
|
|
return config_dir
|
|
|
|
def _get_source_dir(self) -> Optional[Path]:
|
|
"""Override parent method - MCP component doesn't use traditional file installation"""
|
|
return self._get_config_source_dir()
|
|
|
|
def _load_claude_config(self) -> Tuple[Optional[Dict], Path]:
|
|
"""Load user's Claude configuration"""
|
|
claude_config_path = Path.home() / ".claude.json"
|
|
|
|
try:
|
|
with open(claude_config_path, 'r') as f:
|
|
config = json.load(f)
|
|
return config, claude_config_path
|
|
except Exception as e:
|
|
self.logger.error(f"Failed to load Claude config: {e}")
|
|
return None, claude_config_path
|
|
|
|
def _save_claude_config(self, config: Dict, config_path: Path) -> bool:
|
|
"""Save user's Claude configuration with backup"""
|
|
try:
|
|
# Create backup
|
|
backup_path = config_path.with_suffix('.json.backup')
|
|
shutil.copy2(config_path, backup_path)
|
|
self.logger.debug(f"Created backup: {backup_path}")
|
|
|
|
# Save updated config
|
|
with open(config_path, 'w') as f:
|
|
json.dump(config, f, indent=2)
|
|
|
|
self.logger.debug("Updated Claude configuration")
|
|
return True
|
|
except Exception as e:
|
|
self.logger.error(f"Failed to save Claude config: {e}")
|
|
return False
|
|
|
|
def _load_mcp_server_config(self, server_key: str) -> Optional[Dict]:
|
|
"""Load MCP server configuration snippet"""
|
|
if server_key not in self.mcp_servers:
|
|
return None
|
|
|
|
server_info = self.mcp_servers[server_key]
|
|
config_file = server_info["config_file"]
|
|
config_source_dir = self._get_config_source_dir()
|
|
|
|
if not config_source_dir:
|
|
return None
|
|
|
|
config_path = config_source_dir / config_file
|
|
|
|
try:
|
|
with open(config_path, 'r') as f:
|
|
return json.load(f)
|
|
except Exception as e:
|
|
self.logger.error(f"Failed to load MCP config for {server_key}: {e}")
|
|
return None
|
|
|
|
def _install(self, config: Dict[str, Any]) -> bool:
|
|
"""Install MCP component by configuring .claude.json"""
|
|
self.logger.info("Configuring MCP servers in Claude...")
|
|
|
|
# Get selected servers from config
|
|
selected_servers = config.get("selected_mcp_servers", [])
|
|
if not selected_servers:
|
|
self.logger.info("No MCP servers selected - skipping MCP configuration")
|
|
return True
|
|
|
|
self.set_selected_servers(selected_servers)
|
|
|
|
# Validate prerequisites
|
|
success, errors = self.validate_prerequisites()
|
|
if not success:
|
|
for error in errors:
|
|
self.logger.error(error)
|
|
return False
|
|
|
|
# Load Claude configuration
|
|
claude_config, config_path = self._load_claude_config()
|
|
if claude_config is None:
|
|
return False
|
|
|
|
# Ensure mcpServers section exists
|
|
if "mcpServers" not in claude_config:
|
|
claude_config["mcpServers"] = {}
|
|
|
|
# Configure each selected server
|
|
configured_count = 0
|
|
for server_key in selected_servers:
|
|
if server_key not in self.mcp_servers:
|
|
self.logger.warning(f"Unknown MCP server: {server_key}")
|
|
continue
|
|
|
|
server_info = self.mcp_servers[server_key]
|
|
server_config = self._load_mcp_server_config(server_key)
|
|
|
|
if server_config is None:
|
|
self.logger.error(f"Failed to load configuration for {server_key}")
|
|
continue
|
|
|
|
# Handle API key requirements
|
|
if server_info.get("requires_api_key", False):
|
|
api_key_env = server_info.get("api_key_env")
|
|
if api_key_env:
|
|
display_info(f"Server '{server_key}' requires API key: {api_key_env}")
|
|
display_info("You can set this environment variable later")
|
|
|
|
# Merge server config into Claude config
|
|
claude_config["mcpServers"].update(server_config)
|
|
configured_count += 1
|
|
|
|
self.logger.info(f"Configured MCP server: {server_info['name']}")
|
|
|
|
if configured_count == 0:
|
|
self.logger.error("No MCP servers were successfully configured")
|
|
return False
|
|
|
|
# Save updated configuration
|
|
success = self._save_claude_config(claude_config, config_path)
|
|
|
|
if success:
|
|
self.logger.success(f"Successfully configured {configured_count} MCP servers")
|
|
return self._post_install()
|
|
else:
|
|
return False
|
|
|
|
def _post_install(self) -> bool:
|
|
"""Post-installation tasks"""
|
|
try:
|
|
# Update metadata
|
|
metadata_mods = {
|
|
"components": {
|
|
"mcp": {
|
|
"version": "4.0.0",
|
|
"installed": True,
|
|
"servers_configured": len(self.selected_servers),
|
|
"configured_servers": self.selected_servers
|
|
}
|
|
}
|
|
}
|
|
self.settings_manager.update_metadata(metadata_mods)
|
|
self.logger.info("Updated metadata with MCP component registration")
|
|
|
|
return True
|
|
except Exception as e:
|
|
self.logger.error(f"Failed to update metadata: {e}")
|
|
return False
|
|
|
|
def uninstall(self) -> bool:
|
|
"""Uninstall MCP component by removing servers from .claude.json"""
|
|
try:
|
|
self.logger.info("Removing MCP server configurations...")
|
|
|
|
# Load Claude configuration
|
|
claude_config, config_path = self._load_claude_config()
|
|
if claude_config is None:
|
|
self.logger.warning("Could not load Claude config for cleanup")
|
|
return True # Not a failure if config doesn't exist
|
|
|
|
if "mcpServers" not in claude_config:
|
|
self.logger.info("No MCP servers configured")
|
|
return True
|
|
|
|
# Remove all servers we know about
|
|
removed_count = 0
|
|
for server_info in self.mcp_servers.values():
|
|
server_name = server_info["name"]
|
|
if server_name in claude_config["mcpServers"]:
|
|
del claude_config["mcpServers"][server_name]
|
|
removed_count += 1
|
|
self.logger.debug(f"Removed MCP server: {server_name}")
|
|
|
|
# Save updated configuration
|
|
if removed_count > 0:
|
|
success = self._save_claude_config(claude_config, config_path)
|
|
if not success:
|
|
self.logger.warning("Failed to save updated Claude configuration")
|
|
|
|
# Update settings.json
|
|
try:
|
|
if self.settings_manager.is_component_installed("mcp"):
|
|
self.settings_manager.remove_component_registration("mcp")
|
|
self.logger.info("Removed MCP component from settings.json")
|
|
except Exception as e:
|
|
self.logger.warning(f"Could not update settings.json: {e}")
|
|
|
|
self.logger.success(f"MCP component uninstalled ({removed_count} servers removed)")
|
|
return True
|
|
|
|
except Exception as e:
|
|
self.logger.exception(f"Unexpected error during MCP uninstallation: {e}")
|
|
return False
|
|
|
|
def get_dependencies(self) -> List[str]:
|
|
"""Get dependencies"""
|
|
return ["core"]
|
|
|
|
def get_size_estimate(self) -> int:
|
|
"""Get estimated size - minimal since we only modify config"""
|
|
return 4096 # 4KB - just config modifications |