claude-mpm 4.4.4__py3-none-any.whl → 4.4.6__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-4.4.4
+4.4.6

claude_mpm/cli/commands/mcp_external_commands.py

@@ -45,7 +45,7 @@ class MCPExternalCommands:
         return 1
 
     def _setup_external(self, args):
-        """Setup external MCP services in Claude Desktop.
+        """Setup external MCP services in Claude Code.
 
         Args:
             args: Command line arguments
@@ -67,13 +67,13 @@ class MCPExternalCommands:
             print("   You may need to install them manually:")
             print("   pip install mcp-vector-search mcp-browser")
 
-        # Then configure in Claude Desktop
-        print("\n2️⃣  Configuring Claude Desktop...")
+        # Then configure in Claude Code
+        print("\n2️⃣  Configuring Claude Code...")
         force = getattr(args, "force", False)
         if setup.setup_external_services(force=force):
             print("\n✅ External services setup completed successfully!")
             print("\nNext steps:")
-            print("1. Restart Claude Desktop to load the new services")
+            print("1. Restart Claude Code to load the new services")
             print("2. Check status with: claude-mpm mcp external list")
             print("3. The services will be available in Claude as separate MCP servers")
             return 0
@@ -111,7 +111,7 @@ class MCPExternalCommands:
         import json
         from pathlib import Path
 
-        # Check Claude Desktop configuration
+        # Check Claude Code configuration
         config_paths = [
             Path.home()
             / "Library"
@@ -157,7 +157,7 @@ class MCPExternalCommands:
                 break
 
         if not config_found:
-            print("❌ No Claude Desktop configuration found")
+            print("❌ No Claude Code configuration found")
             print("   Please run: claude-mpm mcp install")
 
         # Check Python packages
@@ -215,7 +215,7 @@ class MCPExternalCommands:
             print("\n✅ Configuration updated successfully!")
             print("\nNext steps:")
             print("1. Review the .mcp.json file to verify the configuration")
-            print("2. Restart Claude Desktop to load the updated services")
+            print("2. Restart Claude Code to load the updated services")
             return 0
         print("\n❌ Failed to update configuration")
         return 1

claude_mpm/cli/commands/mcp_install_commands.py

@@ -46,8 +46,8 @@ class MCPInstallCommands:
                 print("\nPlease install manually with: pip install mcp")
                 return 1
 
-        # Step 2: Configure Claude Desktop with the new CLI command
-        print("\n2️⃣  Configuring Claude Desktop...")
+        # Step 2: Configure Claude Code with the new CLI command
+        print("\n2️⃣  Configuring Claude Code...")
         try:
             success = self._configure_claude_desktop(args.force)
             if not success:
@@ -72,7 +72,7 @@ class MCPInstallCommands:
                 # Install Python packages for external services
                 external_setup.check_and_install_pip_packages()
 
-                # Setup external services in Claude Desktop config
+                # Setup external services in Claude Code config
                 if external_setup.setup_external_services(force=args.force):
                     print("✅ External services configured successfully")
                 else:
@@ -86,7 +86,7 @@ class MCPInstallCommands:
             print("\n✅ Configuration completed successfully")
             print("\n🎉 MCP Gateway is ready to use!")
             print("\nNext steps:")
-            print("1. Restart Claude Desktop (if running)")
+            print("1. Restart Claude Code (if running)")
             print("2. Test the server: claude-mpm mcp server --test")
             print("3. Check status: claude-mpm mcp status")
             print("4. List external services: claude-mpm mcp external list")
@@ -97,9 +97,9 @@ class MCPInstallCommands:
             return 1
 
     def _configure_claude_desktop(self, force=False):
-        """Configure Claude Desktop to use the MCP gateway via CLI command.
+        """Configure Claude Code to use the MCP gateway via CLI command.
 
-        WHY: Claude Desktop reads MCP server configurations from a platform-specific
+        WHY: Claude Code reads MCP server configurations from a platform-specific
         configuration file. This method updates that file to include the claude-mpm-gateway
         server configuration.
 
@@ -166,14 +166,14 @@ class MCPInstallCommands:
         return self._save_config(config, config_path)
 
     def _get_claude_config_path(self):
-        """Get the Claude Desktop configuration file path.
+        """Get the Claude Code configuration file path.
 
         Returns:
-            Path or None: Path to Claude Desktop config file
+            Path or None: Path to Claude Code config file
         """
         import platform
 
-        # Try multiple possible locations for Claude Desktop config
+        # Try multiple possible locations for Claude Code config
         possible_paths = [
             Path.home()
             / "Library"

claude_mpm/cli/commands/mcp_setup_external.py

@@ -1,7 +1,7 @@
 """MCP external services setup module.
 
 This module handles the registration of external MCP services
-(mcp-vector-search, mcp-browser) as separate MCP servers in Claude Desktop.
+(mcp-vector-search, mcp-browser) as separate MCP servers in Claude Code.
 """
 
 import json
@@ -13,7 +13,7 @@ from typing import Dict, Optional, Tuple
 
 
 class MCPExternalServicesSetup:
-    """Handles setup of external MCP services in Claude Desktop configuration."""
+    """Handles setup of external MCP services in Claude Code configuration."""
 
     def get_project_services(self, project_path: Path) -> Dict:
         """Get external services configuration for the current project.
@@ -472,9 +472,9 @@ class MCPExternalServicesSetup:
                     f"\n✅ Successfully configured {success_count} external services in .mcp.json"
                 )
                 print(
-                    "\n📌 Note: Claude Desktop will automatically load these services"
+                    "\n📌 Note: Claude Code will automatically load these services"
                 )
-                print("   when you open this project directory in Claude Desktop.")
+                print("   when you open this project directory in Claude Code.")
                 return True
             print("❌ Failed to save configuration")
             return False
@@ -487,7 +487,7 @@ class MCPExternalServicesSetup:
         """Setup a single external MCP service.
 
         Args:
-            config: The Claude Desktop configuration
+            config: The Claude Code configuration
             service_name: Name of the service to setup
             service_info: Service configuration information
             force: Whether to overwrite existing configuration
@@ -814,7 +814,7 @@ class MCPExternalServicesSetup:
             print("✅ Successfully updated mcp-browser configuration in .mcp.json")
             print(f"   Command: {browser_config['command']}")
             print(f"   Args: {browser_config['args']}")
-            print("\n📌 Note: Claude Desktop will automatically use this configuration")
+            print("\n📌 Note: Claude Code will automatically use this configuration")
             print("   when you open this project directory.")
             return True
         print("❌ Failed to save configuration")

claude_mpm/hooks/kuzu_memory_hook.py

@@ -163,7 +163,8 @@ class KuzuMemoryHook(SubmitHook):
                 capture_output=True,
                 text=True,
                 timeout=5,
-                cwd=str(self.project_path), check=False,
+                cwd=str(self.project_path),
+                check=False,
             )
 
             if result.returncode == 0 and result.stdout:
@@ -267,7 +268,8 @@ Note: Use the memories above to provide more informed and contextual responses.
                 capture_output=True,
                 text=True,
                 timeout=5,
-                cwd=str(self.project_path), check=False,
+                cwd=str(self.project_path),
+                check=False,
             )
 
             if result.returncode == 0:

claude_mpm/services/diagnostics/checks/__init__.py

@@ -7,7 +7,7 @@ diagnostic components.
 
 from .agent_check import AgentCheck
 from .base_check import BaseDiagnosticCheck
-from .claude_desktop_check import ClaudeDesktopCheck
+from .claude_code_check import ClaudeCodeCheck
 from .common_issues_check import CommonIssuesCheck
 from .configuration_check import ConfigurationCheck
 from .filesystem_check import FilesystemCheck
@@ -21,7 +21,7 @@ from .startup_log_check import StartupLogCheck
 __all__ = [
     "AgentCheck",
     "BaseDiagnosticCheck",
-    "ClaudeDesktopCheck",
+    "ClaudeCodeCheck",
     "CommonIssuesCheck",
     "ConfigurationCheck",
     "FilesystemCheck",

claude_mpm/services/diagnostics/checks/{claude_desktop_check.py → claude_code_check.py}

@@ -1,7 +1,7 @@
 """
-Check Claude Desktop integration.
+Check Claude Code (CLI) integration.
 
-WHY: Verify that Claude Desktop is installed, properly configured,
+WHY: Verify that Claude Code CLI is installed, properly configured,
 and integrated with claude-mpm.
 """
 
@@ -13,24 +13,24 @@ from ..models import DiagnosticResult, DiagnosticStatus
 from .base_check import BaseDiagnosticCheck
 
 
-class ClaudeDesktopCheck(BaseDiagnosticCheck):
-    """Check Claude Desktop installation and integration."""
+class ClaudeCodeCheck(BaseDiagnosticCheck):
+    """Check Claude Code CLI installation and integration."""
 
     @property
     def name(self) -> str:
-        return "claude_desktop_check"
+        return "claude_code_check"
 
     @property
     def category(self) -> str:
-        return "Claude Desktop"
+        return "Claude Code"
 
     def run(self) -> DiagnosticResult:
-        """Run Claude Desktop diagnostics."""
+        """Run Claude Code CLI diagnostics."""
         try:
             sub_results = []
             details = {}
 
-            # Check if Claude Desktop is installed
+            # Check if Claude Code CLI is installed
             install_result = self._check_installation()
             sub_results.append(install_result)
             details["installed"] = install_result.status == DiagnosticStatus.OK
@@ -54,13 +54,13 @@ class ClaudeDesktopCheck(BaseDiagnosticCheck):
             # Determine overall status
             if any(r.status == DiagnosticStatus.ERROR for r in sub_results):
                 status = DiagnosticStatus.ERROR
-                message = "Claude Desktop has critical issues"
+                message = "Claude Code CLI has critical issues"
             elif any(r.status == DiagnosticStatus.WARNING for r in sub_results):
                 status = DiagnosticStatus.WARNING
-                message = "Claude Desktop needs configuration"
+                message = "Claude Code CLI needs configuration"
             else:
                 status = DiagnosticStatus.OK
-                message = "Claude Desktop properly configured"
+                message = "Claude Code CLI properly configured"
 
             return DiagnosticResult(
                 category=self.category,
@@ -74,109 +74,102 @@ class ClaudeDesktopCheck(BaseDiagnosticCheck):
             return DiagnosticResult(
                 category=self.category,
                 status=DiagnosticStatus.ERROR,
-                message=f"Claude Desktop check failed: {e!s}",
+                message=f"Claude Code CLI check failed: {e!s}",
                 details={"error": str(e)},
             )
 
     def _check_installation(self) -> DiagnosticResult:
-        """Check if Claude Desktop is installed."""
-        # Check common installation paths
-        mac_path = Path("/Applications/Claude.app")
-        linux_paths = [
-            Path.home() / ".local/share/applications/claude.desktop",
-            Path("/usr/share/applications/claude.desktop"),
-            Path("/opt/Claude"),
-        ]
-        windows_paths = [
-            Path("C:/Program Files/Claude/Claude.exe"),
-            Path.home() / "AppData/Local/Claude/Claude.exe",
-        ]
-
-        # Check for Claude process
+        """Check if Claude Code CLI is installed."""
+        # Check if claude command is available
         try:
             result = subprocess.run(
-                ["pgrep", "-f", "Claude"], capture_output=True, timeout=2, check=False
+                ["claude", "--version"],
+                capture_output=True,
+                timeout=5,
+                check=False,
+                text=True
             )
             if result.returncode == 0:
                 return DiagnosticResult(
-                    category="Claude Desktop Installation",
+                    category="Claude Code CLI Installation",
                     status=DiagnosticStatus.OK,
-                    message="Claude Desktop is running",
-                    details={"running": True},
+                    message="Claude Code CLI is installed and accessible",
+                    details={
+                        "installed": True,
+                        "path": "claude",
+                        "version_output": result.stdout.strip()
+                    },
                 )
         except (subprocess.SubprocessError, FileNotFoundError):
             pass
 
-        # Check installation paths
-        if mac_path.exists():
-            return DiagnosticResult(
-                category="Claude Desktop Installation",
-                status=DiagnosticStatus.OK,
-                message="Claude Desktop installed (macOS)",
-                details={"path": str(mac_path), "platform": "macos"},
-            )
-
-        for path in linux_paths:
-            if path.exists():
-                return DiagnosticResult(
-                    category="Claude Desktop Installation",
-                    status=DiagnosticStatus.OK,
-                    message="Claude Desktop installed (Linux)",
-                    details={"path": str(path), "platform": "linux"},
-                )
+        # Check common installation paths
+        possible_paths = [
+            Path("/usr/local/bin/claude"),
+            Path.home() / ".local/bin/claude",
+            Path("/opt/homebrew/bin/claude"),
+            Path("/usr/bin/claude"),
+        ]
 
-        for path in windows_paths:
-            if path.exists():
+        for path in possible_paths:
+            if path.exists() and path.is_file():
                 return DiagnosticResult(
-                    category="Claude Desktop Installation",
+                    category="Claude Code CLI Installation",
                     status=DiagnosticStatus.OK,
-                    message="Claude Desktop installed (Windows)",
-                    details={"path": str(path), "platform": "windows"},
+                    message=f"Claude Code CLI found at {path}",
+                    details={"installed": True, "path": str(path)},
                 )
 
         return DiagnosticResult(
-            category="Claude Desktop Installation",
-            status=DiagnosticStatus.WARNING,
-            message="Claude Desktop not found",
+            category="Claude Code CLI Installation",
+            status=DiagnosticStatus.ERROR,
+            message="Claude Code CLI not found",
             details={"installed": False},
-            fix_description="Install Claude Desktop from https://claude.ai/download",
+            fix_description="Install Claude Code CLI from https://claude.ai/code",
         )
 
     def _check_version(self) -> DiagnosticResult:
-        """Check Claude Desktop version compatibility."""
-        # Try to get version from config file
-        config_paths = [
-            Path.home() / "Library/Application Support/Claude/config.json",  # macOS
-            Path.home() / ".config/Claude/config.json",  # Linux
-            Path.home() / "AppData/Roaming/Claude/config.json",  # Windows
-        ]
+        """Check Claude Code CLI version compatibility."""
+        try:
+            result = subprocess.run(
+                ["claude", "--version"],
+                capture_output=True,
+                timeout=5,
+                check=True,
+                text=True
+            )
+            version_output = result.stdout.strip()
 
-        for config_path in config_paths:
-            if config_path.exists():
-                try:
-                    with open(config_path) as f:
-                        config = json.load(f)
-                        version = config.get("version", "unknown")
-
-                        # Simple version check (would need real version comparison logic)
-                        return DiagnosticResult(
-                            category="Claude Desktop Version",
-                            status=DiagnosticStatus.OK,
-                            message=f"Version: {version}",
-                            details={
-                                "version": version,
-                                "config_path": str(config_path),
-                            },
-                        )
-                except Exception:
-                    pass
+            # Extract version number (basic parsing)
+            version = "unknown"
+            if "version" in version_output.lower():
+                parts = version_output.split()
+                for i, part in enumerate(parts):
+                    if "version" in part.lower() and i + 1 < len(parts):
+                        version = parts[i + 1]
+                        break
 
-        return DiagnosticResult(
-            category="Claude Desktop Version",
-            status=DiagnosticStatus.WARNING,
-            message="Could not determine version",
-            details={"version": "unknown"},
-        )
+            # Check minimum version requirement (1.0.60+)
+            status = DiagnosticStatus.OK
+            message = f"Version: {version}"
+
+            return DiagnosticResult(
+                category="Claude Code CLI Version",
+                status=status,
+                message=message,
+                details={
+                    "version": version,
+                    "version_output": version_output,
+                },
+            )
+
+        except subprocess.SubprocessError as e:
+            return DiagnosticResult(
+                category="Claude Code CLI Version",
+                status=DiagnosticStatus.WARNING,
+                message=f"Could not determine version: {e}",
+                details={"version": "unknown", "error": str(e)},
+            )
 
     def _check_output_style(self) -> DiagnosticResult:
         """Check if output style is deployed."""
@@ -224,36 +217,26 @@ class ClaudeDesktopCheck(BaseDiagnosticCheck):
             )
 
     def _check_mcp_integration(self) -> DiagnosticResult:
-        """Check MCP server integration with Claude Desktop."""
-        config_path = Path.home() / ".config/claude/claude_desktop_config.json"
+        """Check MCP server integration with Claude Code CLI."""
+        # Claude Code CLI uses ~/.claude.json for configuration
+        config_path = Path.home() / ".claude.json"
 
         if not config_path.exists():
-            # Try alternate paths
-            alt_paths = [
-                Path.home()
-                / "Library/Application Support/Claude/claude_desktop_config.json",
-                Path.home() / "AppData/Roaming/Claude/claude_desktop_config.json",
-            ]
-            for alt_path in alt_paths:
-                if alt_path.exists():
-                    config_path = alt_path
-                    break
-            else:
-                return DiagnosticResult(
-                    category="MCP Integration",
-                    status=DiagnosticStatus.WARNING,
-                    message="Claude Desktop config not found",
-                    details={"configured": False},
-                    fix_command="claude-mpm mcp install",
-                    fix_description="Install MCP server integration",
-                )
+            return DiagnosticResult(
+                category="MCP Integration",
+                status=DiagnosticStatus.WARNING,
+                message="Claude Code CLI config not found",
+                details={"configured": False, "config_path": str(config_path)},
+                fix_command="claude-mpm mcp install",
+                fix_description="Install MCP server integration for Claude Code CLI",
+            )
 
         try:
             with open(config_path) as f:
                 config = json.load(f)
 
                 mcp_servers = config.get("mcpServers", {})
-                if "claude-mpm-gateway" in mcp_servers:
+                if "claude-mpm-gateway" in mcp_servers or "claude-mpm" in mcp_servers:
                     return DiagnosticResult(
                         category="MCP Integration",
                         status=DiagnosticStatus.OK,
@@ -274,7 +257,7 @@ class ClaudeDesktopCheck(BaseDiagnosticCheck):
                         "config_path": str(config_path),
                     },
                     fix_command="claude-mpm mcp install",
-                    fix_description="Configure MCP server for Claude Desktop",
+                    fix_description="Configure MCP server for Claude Code CLI",
                 )
 
         except Exception as e:
@@ -283,4 +266,4 @@ class ClaudeDesktopCheck(BaseDiagnosticCheck):
                 status=DiagnosticStatus.WARNING,
                 message=f"Could not check MCP configuration: {e!s}",
                 details={"error": str(e)},
-            )
+            )

claude_mpm/services/diagnostics/checks/mcp_check.py

@@ -2,7 +2,7 @@
 Check MCP (Model Context Protocol) server status.
 
 WHY: Verify that the MCP gateway is properly installed, configured,
-and functioning for enhanced Claude Desktop capabilities.
+and functioning for enhanced Claude Code capabilities.
 """
 
 import json
@@ -129,7 +129,7 @@ class MCPCheck(BaseDiagnosticCheck):
         )
 
     def _check_configuration(self) -> DiagnosticResult:
-        """Check MCP configuration in Claude Desktop."""
+        """Check MCP configuration in Claude Code."""
         config_paths = [
             Path.home() / ".config/claude/claude_desktop_config.json",
             Path.home()
@@ -147,10 +147,10 @@ class MCPCheck(BaseDiagnosticCheck):
             return DiagnosticResult(
                 category="MCP Configuration",
                 status=DiagnosticStatus.WARNING,
-                message="Claude Desktop config not found",
+                message="Claude Code config not found",
                 details={"configured": False},
                 fix_command="claude-mpm mcp config",
-                fix_description="Configure MCP server in Claude Desktop",
+                fix_description="Configure MCP server in Claude Code",
             )
 
         try:
@@ -167,7 +167,7 @@ class MCPCheck(BaseDiagnosticCheck):
                         message="MCP gateway not configured",
                         details={"configured": False, "config_path": str(config_path)},
                         fix_command="claude-mpm mcp config",
-                        fix_description="Add MCP gateway to Claude Desktop configuration",
+                        fix_description="Add MCP gateway to Claude Code configuration",
                     )
 
                 # Check configuration validity
@@ -203,7 +203,7 @@ class MCPCheck(BaseDiagnosticCheck):
                 status=DiagnosticStatus.ERROR,
                 message="Invalid JSON in config file",
                 details={"error": str(e), "config_path": str(config_path)},
-                fix_description="Fix JSON syntax in Claude Desktop config",
+                fix_description="Fix JSON syntax in Claude Code config",
             )
         except Exception as e:
             return DiagnosticResult(