claude-mpm 4.4.4__tar.gz → 4.4.6__tar.gz

{claude_mpm-4.4.4 → claude_mpm-4.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.4.4
+Version: 4.4.6
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team
@@ -41,11 +41,6 @@ Requires-Dist: python-frontmatter>=1.0.0
 Requires-Dist: mistune>=3.0.0
 Requires-Dist: tree-sitter>=0.21.0
 Requires-Dist: ijson>=3.2.0
-Requires-Dist: kuzu-memory>=1.1.1
-Requires-Dist: mcp>=0.1.0
-Requires-Dist: mcp-vector-search>=0.1.0
-Requires-Dist: mcp-browser>=0.1.0
-Requires-Dist: mcp-ticketer>=0.1.0
 Requires-Dist: toml>=0.10.2
 Requires-Dist: packaging>=21.0
 Requires-Dist: pydantic>=2.0.0
@@ -54,6 +49,12 @@ Requires-Dist: rich>=13.0.0
 Requires-Dist: pyee>=13.0.0
 Requires-Dist: importlib-resources>=5.0; python_version < "3.9"
 Requires-Dist: pathspec>=0.11.0
+Provides-Extra: mcp
+Requires-Dist: mcp>=0.1.0; extra == "mcp"
+Requires-Dist: mcp-vector-search>=0.1.0; extra == "mcp"
+Requires-Dist: mcp-browser>=0.1.0; extra == "mcp"
+Requires-Dist: mcp-ticketer>=0.1.0; extra == "mcp"
+Requires-Dist: kuzu-memory>=1.1.1; extra == "mcp"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
@@ -147,7 +148,9 @@ Dynamic: license-file
 
 # Claude MPM - Multi-Agent Project Manager
 
-A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
+A powerful orchestration framework for **Claude Code (CLI)** that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
+
+> **⚠️ Important**: Claude MPM extends **Claude Code (CLI)**, not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
 
 > **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
 
@@ -157,7 +160,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
-- 🔌 **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory automatically installed via pipx
+- 🔌 **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
 - 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
@@ -167,22 +170,33 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 ## Quick Installation
 
 ```bash
+# Basic installation
 pip install claude-mpm
+
+# Install with optional MCP services (recommended)
+pip install "claude-mpm[mcp]"
 ```
 
 Or with pipx (recommended for isolated installation):
 ```bash
-# Install with monitor support (recommended)
-pipx install "claude-mpm[monitor]"
-
-# Basic installation without monitor
+# Basic installation
 pipx install claude-mpm
 
+# Install with optional MCP services (recommended)
+pipx install "claude-mpm[mcp]"
+
+# Install with all features
+pipx install "claude-mpm[mcp,monitor]"
+
 # Configure MCP for pipx users:
 claude-mpm mcp-pipx-config
 ```
 
-**💡 Pipx Tip**: Use `"claude-mpm[monitor]"` to get full monitoring dashboard functionality! The `[monitor]` optional dependency includes Socket.IO and async web server components needed for real-time agent monitoring.
+**💡 Optional Dependencies**:
+- `[mcp]` - Include MCP services (mcp-vector-search, mcp-browser, mcp-ticketer, kuzu-memory)
+- `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
+- **Combine both**: Use `"claude-mpm[mcp,monitor]"` to install all features
+- Without optional dependencies, MCP services auto-install on first use via pipx
 
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
@@ -207,11 +221,14 @@ claude-mpm mcp
 # Run comprehensive health diagnostics
 claude-mpm doctor
 
-# Generate detailed diagnostic report
+# Generate detailed diagnostic report with MCP service analysis
 claude-mpm doctor --verbose --output-file doctor-report.md
 
-# Run specific diagnostic checks
-claude-mpm doctor --checks installation configuration agents
+# Run specific diagnostic checks including MCP services
+claude-mpm doctor --checks installation configuration agents mcp
+
+# Check MCP service status specifically
+claude-mpm doctor --checks mcp --verbose
 
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
@@ -225,7 +242,7 @@ See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
 
 - **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
-- **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory install automatically via pipx
+- **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
 - **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
 - **Service-Oriented Architecture**: Simplified five specialized service domains
 - **Interface-Based Contracts**: All services implement explicit interfaces
@@ -383,5 +400,5 @@ MIT License - see [LICENSE](LICENSE) file.
 ## Credits
 
 - Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)
-- Enhanced for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) integration
+- Enhanced for [Claude Code (CLI)](https://docs.anthropic.com/en/docs/claude-code) integration
 - Built with ❤️ by the Claude MPM community

{claude_mpm-4.4.4 → claude_mpm-4.4.6}/README.md

@@ -1,6 +1,8 @@
 # Claude MPM - Multi-Agent Project Manager
 
-A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
+A powerful orchestration framework for **Claude Code (CLI)** that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
+
+> **⚠️ Important**: Claude MPM extends **Claude Code (CLI)**, not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
 
 > **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
 
@@ -10,7 +12,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
-- 🔌 **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory automatically installed via pipx
+- 🔌 **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
 - 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
@@ -20,22 +22,33 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 ## Quick Installation
 
 ```bash
+# Basic installation
 pip install claude-mpm
+
+# Install with optional MCP services (recommended)
+pip install "claude-mpm[mcp]"
 ```
 
 Or with pipx (recommended for isolated installation):
 ```bash
-# Install with monitor support (recommended)
-pipx install "claude-mpm[monitor]"
-
-# Basic installation without monitor
+# Basic installation
 pipx install claude-mpm
 
+# Install with optional MCP services (recommended)
+pipx install "claude-mpm[mcp]"
+
+# Install with all features
+pipx install "claude-mpm[mcp,monitor]"
+
 # Configure MCP for pipx users:
 claude-mpm mcp-pipx-config
 ```
 
-**💡 Pipx Tip**: Use `"claude-mpm[monitor]"` to get full monitoring dashboard functionality! The `[monitor]` optional dependency includes Socket.IO and async web server components needed for real-time agent monitoring.
+**💡 Optional Dependencies**:
+- `[mcp]` - Include MCP services (mcp-vector-search, mcp-browser, mcp-ticketer, kuzu-memory)
+- `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
+- **Combine both**: Use `"claude-mpm[mcp,monitor]"` to install all features
+- Without optional dependencies, MCP services auto-install on first use via pipx
 
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
@@ -60,11 +73,14 @@ claude-mpm mcp
 # Run comprehensive health diagnostics
 claude-mpm doctor
 
-# Generate detailed diagnostic report
+# Generate detailed diagnostic report with MCP service analysis
 claude-mpm doctor --verbose --output-file doctor-report.md
 
-# Run specific diagnostic checks
-claude-mpm doctor --checks installation configuration agents
+# Run specific diagnostic checks including MCP services
+claude-mpm doctor --checks installation configuration agents mcp
+
+# Check MCP service status specifically
+claude-mpm doctor --checks mcp --verbose
 
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
@@ -78,7 +94,7 @@ See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
 
 - **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
-- **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory install automatically via pipx
+- **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
 - **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
 - **Service-Oriented Architecture**: Simplified five specialized service domains
 - **Interface-Based Contracts**: All services implement explicit interfaces
@@ -236,5 +252,5 @@ MIT License - see [LICENSE](LICENSE) file.
 ## Credits
 
 - Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)
-- Enhanced for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) integration
+- Enhanced for [Claude Code (CLI)](https://docs.anthropic.com/en/docs/claude-code) integration
 - Built with ❤️ by the Claude MPM community

claude_mpm-4.4.6/VERSION

@@ -0,0 +1 @@
+4.4.6

{claude_mpm-4.4.4 → claude_mpm-4.4.6}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.4.4"
+version = "4.4.6"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
 keywords = [ "claude", "orchestration", "multi-agent", "ticket-management",]
 classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12",]
-dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "tree-sitter>=0.21.0", "ijson>=3.2.0", "kuzu-memory>=1.1.1", "mcp>=0.1.0", "mcp-vector-search>=0.1.0", "mcp-browser>=0.1.0", "mcp-ticketer>=0.1.0", "toml>=0.10.2", "packaging>=21.0", "pydantic>=2.0.0", "pydantic-settings>=2.0.0", "rich>=13.0.0", "pyee>=13.0.0", "importlib-resources>=5.0; python_version < '3.9'", "pathspec>=0.11.0",]
+dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "tree-sitter>=0.21.0", "ijson>=3.2.0", "toml>=0.10.2", "packaging>=21.0", "pydantic>=2.0.0", "pydantic-settings>=2.0.0", "rich>=13.0.0", "pyee>=13.0.0", "importlib-resources>=5.0; python_version < '3.9'", "pathspec>=0.11.0",]
 [[project.authors]]
 name = "Bob Matsuoka"
 email = "bob@matsuoka.com"
@@ -28,6 +28,7 @@ Issues = "https://github.com/bobmatnyc/claude-mpm/issues"
 Documentation = "https://github.com/bobmatnyc/claude-mpm/blob/main/README.md"
 
 [project.optional-dependencies]
+mcp = [ "mcp>=0.1.0", "mcp-vector-search>=0.1.0", "mcp-browser>=0.1.0", "mcp-ticketer>=0.1.0", "kuzu-memory>=1.1.1",]
 dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "flake8-import-order", "flake8-tidy-imports", "flake8-bugbear", "ruff>=0.1.0", "pylint>=3.0.0", "pre-commit", "mypy>=1.0.0", "types-PyYAML>=6.0.0", "types-requests>=2.25.0",]
 docs = [ "sphinx>=7.2.0", "sphinx-rtd-theme>=1.3.0", "sphinx-autobuild>=2021.3.14",]
 monitor = [ "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0",]
@@ -79,7 +80,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.4.4"
+version = "4.4.6"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.4.6/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.4.6

{claude_mpm-4.4.4 → claude_mpm-4.4.6}/src/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-4.4.4 → claude_mpm-4.4.6}/src/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-4.4.4 → claude_mpm-4.4.6}/src/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-4.4.4 → claude_mpm-4.4.6}/src/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-4.4.4 → claude_mpm-4.4.6}/src/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",