claude-mpm 3.9.7__py3-none-any.whl → 3.9.8__py3-none-any.whl

claude_mpm/services/mcp_gateway/core/interfaces.py

@@ -0,0 +1,476 @@
+"""
+MCP Gateway Interface Definitions
+==================================
+
+This module defines the core interfaces for the MCP Gateway service,
+establishing contracts for dependency injection and service orchestration.
+
+Part of ISS-0034: Infrastructure Setup - MCP Gateway Project Foundation
+"""
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List, Optional, Callable, Union
+from dataclasses import dataclass
+from datetime import datetime
+from pathlib import Path
+import asyncio
+
+
+# Tool-related data structures
+@dataclass
+class MCPToolDefinition:
+    """Definition of an MCP tool."""
+    name: str
+    description: str
+    input_schema: Dict[str, Any]
+    output_schema: Optional[Dict[str, Any]] = None
+    version: str = "1.0.0"
+    metadata: Optional[Dict[str, Any]] = None
+
+
+@dataclass
+class MCPToolInvocation:
+    """Represents a tool invocation request."""
+    tool_name: str
+    parameters: Dict[str, Any]
+    context: Optional[Dict[str, Any]] = None
+    timeout: Optional[float] = None
+    request_id: Optional[str] = None
+
+
+@dataclass
+class MCPToolResult:
+    """Result from a tool invocation."""
+    success: bool
+    data: Optional[Any] = None
+    error: Optional[str] = None
+    metadata: Optional[Dict[str, Any]] = None
+    execution_time: Optional[float] = None
+
+
+# Core MCP interfaces
+class IMCPConfiguration(ABC):
+    """
+    Interface for MCP configuration management.
+    
+    Handles loading, validation, and access to MCP Gateway configuration.
+    """
+    
+    @abstractmethod
+    def load_config(self, config_path: Path) -> bool:
+        """
+        Load configuration from a file.
+        
+        Args:
+            config_path: Path to configuration file
+            
+        Returns:
+            True if configuration loaded successfully
+        """
+        pass
+    
+    @abstractmethod
+    def get(self, key: str, default: Any = None) -> Any:
+        """
+        Get configuration value by key.
+        
+        Args:
+            key: Configuration key (supports dot notation)
+            default: Default value if key not found
+            
+        Returns:
+            Configuration value or default
+        """
+        pass
+    
+    @abstractmethod
+    def set(self, key: str, value: Any) -> None:
+        """
+        Set configuration value.
+        
+        Args:
+            key: Configuration key (supports dot notation)
+            value: Configuration value
+        """
+        pass
+    
+    @abstractmethod
+    def validate(self) -> bool:
+        """
+        Validate the current configuration.
+        
+        Returns:
+            True if configuration is valid
+        """
+        pass
+    
+    @abstractmethod
+    def get_server_config(self) -> Dict[str, Any]:
+        """
+        Get MCP server configuration.
+        
+        Returns:
+            Server configuration dictionary
+        """
+        pass
+    
+    @abstractmethod
+    def get_tools_config(self) -> Dict[str, Any]:
+        """
+        Get tools configuration.
+        
+        Returns:
+            Tools configuration dictionary
+        """
+        pass
+
+
+class IMCPToolAdapter(ABC):
+    """
+    Interface for MCP tool adapters.
+    
+    Tool adapters wrap external tools to make them MCP-compatible.
+    """
+    
+    @abstractmethod
+    def get_definition(self) -> MCPToolDefinition:
+        """
+        Get the tool definition.
+        
+        Returns:
+            Tool definition with schema and metadata
+        """
+        pass
+    
+    @abstractmethod
+    async def invoke(self, invocation: MCPToolInvocation) -> MCPToolResult:
+        """
+        Invoke the tool with given parameters.
+        
+        Args:
+            invocation: Tool invocation request
+            
+        Returns:
+            Tool execution result
+        """
+        pass
+    
+    @abstractmethod
+    def validate_parameters(self, parameters: Dict[str, Any]) -> bool:
+        """
+        Validate tool parameters against schema.
+        
+        Args:
+            parameters: Parameters to validate
+            
+        Returns:
+            True if parameters are valid
+        """
+        pass
+    
+    @abstractmethod
+    async def initialize(self) -> bool:
+        """
+        Initialize the tool adapter.
+        
+        Returns:
+            True if initialization successful
+        """
+        pass
+    
+    @abstractmethod
+    async def shutdown(self) -> None:
+        """
+        Shutdown the tool adapter and clean up resources.
+        """
+        pass
+
+
+class IMCPToolRegistry(ABC):
+    """
+    Interface for MCP tool registry.
+    
+    Manages registration, discovery, and invocation of MCP tools.
+    """
+    
+    @abstractmethod
+    def register_tool(self, adapter: IMCPToolAdapter) -> bool:
+        """
+        Register a tool adapter.
+        
+        Args:
+            adapter: Tool adapter to register
+            
+        Returns:
+            True if registration successful
+        """
+        pass
+    
+    @abstractmethod
+    def unregister_tool(self, tool_name: str) -> bool:
+        """
+        Unregister a tool by name.
+        
+        Args:
+            tool_name: Name of tool to unregister
+            
+        Returns:
+            True if unregistration successful
+        """
+        pass
+    
+    @abstractmethod
+    def get_tool(self, tool_name: str) -> Optional[IMCPToolAdapter]:
+        """
+        Get a tool adapter by name.
+        
+        Args:
+            tool_name: Name of the tool
+            
+        Returns:
+            Tool adapter if found, None otherwise
+        """
+        pass
+    
+    @abstractmethod
+    def list_tools(self) -> List[MCPToolDefinition]:
+        """
+        List all registered tools.
+        
+        Returns:
+            List of tool definitions
+        """
+        pass
+    
+    @abstractmethod
+    async def invoke_tool(self, invocation: MCPToolInvocation) -> MCPToolResult:
+        """
+        Invoke a tool through the registry.
+        
+        Args:
+            invocation: Tool invocation request
+            
+        Returns:
+            Tool execution result
+        """
+        pass
+    
+    @abstractmethod
+    def search_tools(self, query: str) -> List[MCPToolDefinition]:
+        """
+        Search for tools by query.
+        
+        Args:
+            query: Search query
+            
+        Returns:
+            List of matching tool definitions
+        """
+        pass
+
+
+class IMCPCommunication(ABC):
+    """
+    Interface for MCP communication handling.
+    
+    Manages stdio-based communication with MCP clients.
+    """
+    
+    @abstractmethod
+    async def send_message(self, message: Dict[str, Any]) -> None:
+        """
+        Send a message to the MCP client.
+        
+        Args:
+            message: Message to send
+        """
+        pass
+    
+    @abstractmethod
+    async def receive_message(self) -> Optional[Dict[str, Any]]:
+        """
+        Receive a message from the MCP client.
+        
+        Returns:
+            Received message or None if no message available
+        """
+        pass
+    
+    @abstractmethod
+    async def send_response(self, request_id: str, result: Any) -> None:
+        """
+        Send a response to a request.
+        
+        Args:
+            request_id: ID of the request being responded to
+            result: Result data
+        """
+        pass
+    
+    @abstractmethod
+    async def send_error(self, request_id: str, error: str, code: int = -1) -> None:
+        """
+        Send an error response.
+        
+        Args:
+            request_id: ID of the request that caused the error
+            error: Error message
+            code: Error code
+        """
+        pass
+    
+    @abstractmethod
+    def is_connected(self) -> bool:
+        """
+        Check if communication channel is connected.
+        
+        Returns:
+            True if connected
+        """
+        pass
+
+
+class IMCPLifecycle(ABC):
+    """
+    Interface for MCP service lifecycle management.
+    
+    Manages initialization, startup, shutdown, and health monitoring.
+    """
+    
+    @abstractmethod
+    async def initialize(self) -> bool:
+        """
+        Initialize the MCP service.
+        
+        Returns:
+            True if initialization successful
+        """
+        pass
+    
+    @abstractmethod
+    async def start(self) -> bool:
+        """
+        Start the MCP service.
+        
+        Returns:
+            True if startup successful
+        """
+        pass
+    
+    @abstractmethod
+    async def stop(self) -> None:
+        """
+        Stop the MCP service gracefully.
+        """
+        pass
+    
+    @abstractmethod
+    async def restart(self) -> bool:
+        """
+        Restart the MCP service.
+        
+        Returns:
+            True if restart successful
+        """
+        pass
+    
+    @abstractmethod
+    def get_state(self) -> str:
+        """
+        Get current service state.
+        
+        Returns:
+            Service state (e.g., "initialized", "running", "stopped")
+        """
+        pass
+    
+    @abstractmethod
+    def is_healthy(self) -> bool:
+        """
+        Check if service is healthy.
+        
+        Returns:
+            True if service is healthy
+        """
+        pass
+    
+    @abstractmethod
+    def get_health_status(self) -> Dict[str, Any]:
+        """
+        Get detailed health status.
+        
+        Returns:
+            Health status information
+        """
+        pass
+
+
+class IMCPServer(IMCPLifecycle):
+    """
+    Main interface for MCP server implementation.
+    
+    Orchestrates tool registry, communication, and request handling.
+    """
+    
+    @abstractmethod
+    def set_tool_registry(self, registry: IMCPToolRegistry) -> None:
+        """
+        Set the tool registry for the server.
+        
+        Args:
+            registry: Tool registry to use
+        """
+        pass
+    
+    @abstractmethod
+    def set_communication(self, communication: IMCPCommunication) -> None:
+        """
+        Set the communication handler.
+        
+        Args:
+            communication: Communication handler to use
+        """
+        pass
+    
+    @abstractmethod
+    async def handle_request(self, request: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Handle an MCP request.
+        
+        Args:
+            request: MCP request message
+            
+        Returns:
+            Response message
+        """
+        pass
+    
+    @abstractmethod
+    async def run(self) -> None:
+        """
+        Run the MCP server main loop.
+        
+        This method should handle incoming requests and manage the server lifecycle.
+        """
+        pass
+    
+    @abstractmethod
+    def register_handler(self, method: str, handler: Callable) -> None:
+        """
+        Register a custom request handler.
+        
+        Args:
+            method: Method name to handle
+            handler: Handler function
+        """
+        pass
+    
+    @abstractmethod
+    def get_capabilities(self) -> Dict[str, Any]:
+        """
+        Get server capabilities.
+        
+        Returns:
+            Dictionary of server capabilities
+        """
+        pass

claude_mpm/services/mcp_gateway/registry/__init__.py

@@ -0,0 +1,9 @@
+"""
+MCP Gateway Registry Module
+===========================
+
+Service discovery and registration for the MCP Gateway.
+"""
+
+# Placeholder for future implementation
+# Will be implemented as part of tool and service discovery

claude_mpm/services/mcp_gateway/server/__init__.py

@@ -0,0 +1,9 @@
+"""
+MCP Gateway Server Module
+=========================
+
+Server implementation for the MCP Gateway.
+"""
+
+# Placeholder for future implementation
+# Will be implemented in ISS-0035: MCP Server Core Implementation

claude_mpm/services/mcp_gateway/tools/__init__.py

@@ -0,0 +1,9 @@
+"""
+MCP Gateway Tools Module
+========================
+
+Tool registry and adapter implementations for the MCP Gateway.
+"""
+
+# Placeholder for future implementation
+# Will be implemented in ISS-0036: Tool Registry & Discovery System

{claude_mpm-3.9.7.dist-info → claude_mpm-3.9.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.9.7
+Version: 3.9.8
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -37,6 +37,7 @@ Requires-Dist: python-engineio>=4.8.0
 Requires-Dist: python-frontmatter>=1.0.0
 Requires-Dist: mistune>=3.0.0
 Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: mcp>=0.1.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"

{claude_mpm-3.9.7.dist-info → claude_mpm-3.9.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-claude_mpm/VERSION,sha256=d3i7x6wOmm1dHxwqFEvbXR3fz1QAv2OUzhc_G3o9AHk,5
+claude_mpm/VERSION,sha256=h01io9HCAB1m4bnlQNdifYpyeVWWMCfYdccCRf4Vw2A,6
 claude_mpm/__init__.py,sha256=_adJRYaqKpyQFHGdsXrUgODkLmAXt4NRTj8khx4miAY,1512
 claude_mpm/__main__.py,sha256=8IcM9tEbTqSN_er04eKTPX3AGo6qzRiTnPI7KfIf7rw,641
 claude_mpm/constants.py,sha256=2r2YXHgILU9Vf_HW3alxx7Ma6rk72C0-arsyDqLMZrY,5248
@@ -32,7 +32,7 @@ claude_mpm/agents/templates/qa.json,sha256=ObztCsMr9haahOaHvaLDRHYj1TZwRxECuzluK
 claude_mpm/agents/templates/research.json,sha256=WlPnKlojeiCBZ4H75nWexLl_dHU5cSORIqLCDp4tCMM,8419
 claude_mpm/agents/templates/research_memory_efficient.json,sha256=WlPnKlojeiCBZ4H75nWexLl_dHU5cSORIqLCDp4tCMM,8419
 claude_mpm/agents/templates/security.json,sha256=KAJOIZeYUPbnC83S2q7ufwdmpS1xrEwWW6H9bvSNVdo,12349
-claude_mpm/agents/templates/ticketing.json,sha256=Kt9lyIXP5R_XTFrTH9ePkkPDnj9y4s-CQv7y4Hy2QVc,30054
+claude_mpm/agents/templates/ticketing.json,sha256=H4-RJHATbDPv07iK_Heff8GdYZRf3d6uIL9_L_KDKwM,33920
 claude_mpm/agents/templates/version_control.json,sha256=yaRwaFA2JjMzCfGki2RIylKytjiVcn-lJKJ3jzTbuyY,11692
 claude_mpm/agents/templates/web_qa.json,sha256=4enHHY0KonWE7c2zS_P7JPoOG1foarMtI4CzUpZp49k,17634
 claude_mpm/agents/templates/web_ui.json,sha256=M4ILRYG_EhIilUcu93XVlO51BiVh72M4p7XvUbTqkcs,22752
@@ -146,7 +146,7 @@ claude_mpm/models/agent_session.py,sha256=cBl71q33TIBX8S6U1w2UnKOjEWyypFB04s0BCy
 claude_mpm/scripts/__init__.py,sha256=zKYLZfT0P5z7C7r1YrhsTDnnyFXY-2awxhLVPYx68ek,552
 claude_mpm/scripts/socketio_daemon.py,sha256=93jzq-h5GQRK-xYpLaovaqNAXtwR_ZqYjmEMmFn0xE8,9741
 claude_mpm/scripts/start_activity_logging.py,sha256=9xTu6Kd9lmCx17vMmoAGRXegoaZIVqLzLJoXQDeZ9Yw,2917
-claude_mpm/services/__init__.py,sha256=4sQ3HgvZnZQuEXBiEYR1u34lDql7upAQUgfd5msBF70,7106
+claude_mpm/services/__init__.py,sha256=cO6w9pl5LWGZ955ZyzNzNe6-qvDnMxkLyVJ7Xys3hS8,8188
 claude_mpm/services/async_session_logger.py,sha256=bCQ-7dlkZlbffTcG2b-CO5Y9UZoBvHwwyu1Ueaqo2Os,21829
 claude_mpm/services/claude_session_logger.py,sha256=VgXOo45k2hCqxLGyHzuOmdQZRk0-S8KVzVUNHas7Bbk,10535
 claude_mpm/services/event_aggregator.py,sha256=Ty2hwDS3IbH9PD1u7NPbPAJM-UFcuOTNeCJ0Tns84LA,20478
@@ -217,6 +217,18 @@ claude_mpm/services/framework_claude_md_generator/section_generators/troubleshoo
 claude_mpm/services/infrastructure/__init__.py,sha256=rZir3Ktwc0Dyrc0Sl2rAn7h6uc8VBp7QWcnRRK3kQ5Y,504
 claude_mpm/services/infrastructure/logging.py,sha256=LuujazzNebzfOCB921wSAUpGDrIxkMrlsvLxI4e1RRo,6693
 claude_mpm/services/infrastructure/monitoring.py,sha256=OPyT976wENCMFzid88ovG5HLqCo71evYqTVn5lsJ4SU,33882
+claude_mpm/services/mcp_gateway/__init__.py,sha256=cxoD-Bpwfg--W7P_c0KY6vUjy8HrlUdCAo5s9KjAGGY,3866
+claude_mpm/services/mcp_gateway/config/__init__.py,sha256=nBj4JSBi2A9TFNXw_nM6tdoLMrServ-yqzMBvFruGlg,385
+claude_mpm/services/mcp_gateway/config/config_loader.py,sha256=dIajqrDboSY7ArAoAOzlXqQarqix6i9ZEjpcVpofygo,7611
+claude_mpm/services/mcp_gateway/config/config_schema.py,sha256=cP1FZoLd_RSuFnP51aLN36f2ifzDWQalBAEeisHUj_Y,9452
+claude_mpm/services/mcp_gateway/config/configuration.py,sha256=Zp8FhPQ_Xp5cfEfa3ktblX1En2neHXb-vGbEqdfyJJY,12658
+claude_mpm/services/mcp_gateway/core/__init__.py,sha256=5alHHmyb6SKrF-HX00fALk8L-XecBgC0WWULvQ1_HK4,919
+claude_mpm/services/mcp_gateway/core/base.py,sha256=zZ36EYvjLEhm75E4q7sB5SZltYCGp4N3SrP3Tu9DHOE,10639
+claude_mpm/services/mcp_gateway/core/exceptions.py,sha256=aygJk4qLI4dJXvpBhvxXz9GS7WlBxtHvaXMIUWhmx6M,6924
+claude_mpm/services/mcp_gateway/core/interfaces.py,sha256=Z1b71vA444yExicMZr9PCzlY7Y9iRS-E6kdkcvKcmt0,11075
+claude_mpm/services/mcp_gateway/registry/__init__.py,sha256=ePGM1q7smHcPo0kKgzDfMXIfg4Vs35xq_J_7pnSgePI,221
+claude_mpm/services/mcp_gateway/server/__init__.py,sha256=aLT78iptTwoCOjMgFV5gyyWQwmbj1Z2aV1ClZYMTyJY,210
+claude_mpm/services/mcp_gateway/tools/__init__.py,sha256=n7niUlLV7DMk6VfpAJyIQRPibdZSuIQLO-kiZ9-04eo,230
 claude_mpm/services/memory/__init__.py,sha256=XkRcNRalLYPClYc8CX9PNhmSqSI5FNHatMfiGHCuW4o,394
 claude_mpm/services/memory/builder.py,sha256=a3X3mZsd3YxmhwOYsAmbpmCACkoKxcuKuyHXPa26gqs,34075
 claude_mpm/services/memory/indexed_memory.py,sha256=nb2bVxFelNyJ9GINw5mPABj8wNJJ23XyTNZ9NgywB1w,20098
@@ -262,9 +274,9 @@ claude_mpm/utils/session_logging.py,sha256=9G0AzB7V0WkhLQlN0ocqbyDv0ifooEsJ5UPXI
 claude_mpm/validation/__init__.py,sha256=bJ19g9lnk7yIjtxzN8XPegp87HTFBzCrGQOpFgRTf3g,155
 claude_mpm/validation/agent_validator.py,sha256=OEYhmy0K99pkoCCoVea2Q-d1JMiDyhEpzEJikuF8T-U,20910
 claude_mpm/validation/frontmatter_validator.py,sha256=vSinu0XD9-31h0-ePYiYivBbxTZEanhymLinTCODr7k,7206
-claude_mpm-3.9.7.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
-claude_mpm-3.9.7.dist-info/METADATA,sha256=HYbNV-C8c4Elozu8w91XNz6Tx4wiad_2Ap9WjD5p3aI,8680
-claude_mpm-3.9.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-3.9.7.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
-claude_mpm-3.9.7.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-3.9.7.dist-info/RECORD,,
+claude_mpm-3.9.8.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
+claude_mpm-3.9.8.dist-info/METADATA,sha256=Ug3P-YCt3Ygy2GYebTt0Lfc8PP6sns2pKZ4zvr8VjVU,8706
+claude_mpm-3.9.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-3.9.8.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
+claude_mpm-3.9.8.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-3.9.8.dist-info/RECORD,,