tooluniverse 0.2.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

tooluniverse/mcp_client_tool.py

@@ -0,0 +1,764 @@
+"""
+MCP Client Tool for ToolUniverse
+
+This module provides a tool that acts as a client to connect to an existing MCP server,
+supporting all MCP functionality including tools, resources, and prompts.
+"""
+
+import json
+import asyncio
+import websockets
+import aiohttp
+import uuid
+from typing import Dict, List, Any, Optional
+from urllib.parse import urljoin
+import warnings
+from .base_tool import BaseTool
+from .tool_registry import register_tool
+import os
+
+
+class BaseMCPClient:
+    """
+    Base MCP client with common functionality shared between MCPClientTool and MCPAutoLoaderTool.
+    Provides session management, request handling, and async cleanup patterns.
+    """
+
+    def __init__(self, server_url: str, transport: str = "http", timeout: int = 30):
+        self.server_url = os.path.expandvars(server_url)
+        self.transport = transport
+        self.timeout = timeout
+        self.session = None
+        self.mcp_session_id = None
+        self._initialized = False
+
+        # Validate transport
+        supported_transports = ["http", "websocket"]
+        if self.transport not in supported_transports:
+            raise ValueError(
+                f"Invalid transport '{self.transport}'. Supported: {supported_transports}"
+            )
+
+    async def _ensure_session(self):
+        """Ensure HTTP session is available for HTTP transport"""
+        if self.transport == "http" and self.session is None:
+            connector = aiohttp.TCPConnector()
+            timeout = aiohttp.ClientTimeout(total=self.timeout)
+            self.session = aiohttp.ClientSession(connector=connector, timeout=timeout)
+
+    async def _close_session(self):
+        """Close HTTP session if exists"""
+        if self.session:
+            try:
+                await self.session.close()
+            except Exception:
+                pass  # Ignore errors during cleanup
+            finally:
+                self.session = None
+                self.mcp_session_id = None
+                self._initialized = False
+
+    def _get_mcp_endpoint(self, path: str) -> str:
+        """Get the full MCP endpoint URL"""
+        if self.transport == "http":
+            base_url = self.server_url.rstrip("/")
+            if not base_url.endswith("/mcp"):
+                base_url += "/mcp"
+            return urljoin(base_url + "/", path)
+        return self.server_url
+
+    async def _initialize_mcp_session(self):
+        """Initialize MCP session if needed (for compatibility with different MCP servers)"""
+        if self._initialized:
+            return
+
+        await self._ensure_session()
+
+        # Try to get session ID from server
+        try:
+            url = f"{self.server_url.rstrip('/')}/mcp"
+            test_payload = {"jsonrpc": "2.0", "id": 1, "method": "tools/list"}
+
+            headers = {
+                "Content-Type": "application/json",
+                "Accept": "application/json, text/event-stream",
+            }
+
+            async with self.session.post(
+                url, json=test_payload, headers=headers
+            ) as response:
+                session_id = response.headers.get("mcp-session-id")
+                if session_id:
+                    self.mcp_session_id = session_id
+
+                if response.status in [200, 400, 406, 500]:
+                    self._initialized = True
+                    return
+
+        except Exception:
+            pass
+
+        # Fallback: generate session ID
+        if not self.mcp_session_id:
+            self.mcp_session_id = str(uuid.uuid4()).replace("-", "")
+
+        self._initialized = True
+
+    async def _make_mcp_request(
+        self, method: str, params: Optional[Dict] = None
+    ) -> Dict[str, Any]:
+        """Make an MCP JSON-RPC request"""
+        request_id = "1"
+
+        payload = {"jsonrpc": "2.0", "id": request_id, "method": method}
+
+        if params:
+            payload["params"] = params
+
+        if self.transport == "http":
+            await self._ensure_session()
+            await self._initialize_mcp_session()  # Ensure session is initialized
+
+            headers = {
+                "Content-Type": "application/json",
+                "Accept": "application/json, text/event-stream",
+            }
+
+            # Add session ID if available
+            if self.mcp_session_id:
+                headers["mcp-session-id"] = self.mcp_session_id
+
+            endpoint = self._get_mcp_endpoint("")
+
+            async with self.session.post(
+                endpoint, json=payload, headers=headers
+            ) as response:
+                if response.status != 200:
+                    raise Exception(
+                        f"MCP request failed with status {response.status}: {await response.text()}"
+                    )
+
+                content_type = response.headers.get("content-type", "").lower()
+
+                if "text/event-stream" in content_type:
+                    # Handle Server-Sent Events format
+                    response_text = await response.text()
+
+                    for line in response_text.split("\n"):
+                        line = line.strip()
+                        if line.startswith("data: "):
+                            json_data = line[6:]
+                            try:
+                                result = json.loads(json_data)
+                                break
+                            except json.JSONDecodeError:
+                                continue
+                    else:
+                        raise Exception(
+                            f"Failed to parse SSE response: {response_text}"
+                        )
+
+                elif "application/json" in content_type:
+                    result = await response.json()
+                else:
+                    try:
+                        result = await response.json()
+                    except Exception:
+                        response_text = await response.text()
+                        raise Exception(
+                            f"Unexpected content type {content_type}. Response: {response_text}"
+                        )
+
+                if "error" in result:
+                    raise Exception(f"MCP error: {result['error']}")
+
+                return result.get("result", {})
+
+        elif self.transport == "websocket":
+            async with websockets.connect(self.server_url) as websocket:
+                await websocket.send(json.dumps(payload))
+                response = await websocket.recv()
+                result = json.loads(response)
+
+                if "error" in result:
+                    raise Exception(f"MCP error: {result['error']}")
+
+                return result.get("result", {})
+
+        else:
+            raise ValueError(f"Unsupported transport: {self.transport}")
+
+    def _run_with_cleanup(self, async_func):
+        """Common async execution pattern with proper cleanup"""
+        try:
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+            return loop.run_until_complete(async_func())
+        finally:
+            try:
+                pending = asyncio.all_tasks(loop)
+                for task in pending:
+                    task.cancel()
+                if pending:
+                    loop.run_until_complete(
+                        asyncio.gather(*pending, return_exceptions=True)
+                    )
+                loop.close()
+            except Exception:
+                pass
+
+
+@register_tool("MCPClientTool")
+class MCPClientTool(BaseTool, BaseMCPClient):
+    """
+    A tool that acts as an MCP client to connect to existing MCP servers.
+    Supports both HTTP and WebSocket transports.
+    """
+
+    def __init__(self, tool_config):
+        BaseTool.__init__(self, tool_config)
+        BaseMCPClient.__init__(
+            self,
+            server_url=tool_config.get("server_url", "http://localhost:8000"),
+            transport=tool_config.get("transport", "http"),
+            timeout=tool_config.get("timeout", 600),
+        )
+
+        # Debug logging for transport configuration
+        tool_name = tool_config.get("name", "Unknown")
+        print(
+            f"MCP Tool Init: {tool_name} -> transport={self.transport}, server={self.server_url}"
+        )
+
+        self._tools_cache = None
+        self._resources_cache = None
+        self._prompts_cache = None
+
+    async def list_tools(self) -> List[Dict[str, Any]]:
+        """List available tools from the MCP server"""
+        if self._tools_cache is None:
+            result = await self._make_mcp_request("tools/list")
+            self._tools_cache = result.get("tools", [])
+        return self._tools_cache
+
+    async def call_tool(self, name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:
+        """Call a tool on the MCP server"""
+        params = {"name": name, "arguments": arguments}
+
+        result = await self._make_mcp_request("tools/call", params)
+        return result
+
+    async def list_resources(self) -> List[Dict[str, Any]]:
+        """List available resources from the MCP server"""
+        if self._resources_cache is None:
+            try:
+                result = await self._make_mcp_request("resources/list")
+                self._resources_cache = result.get("resources", [])
+            except Exception:
+                # Some servers might not support resources
+                self._resources_cache = []
+        return self._resources_cache
+
+    async def read_resource(self, uri: str) -> Dict[str, Any]:
+        """Read a resource from the MCP server"""
+        params = {"uri": uri}
+        result = await self._make_mcp_request("resources/read", params)
+        return result
+
+    async def list_prompts(self) -> List[Dict[str, Any]]:
+        """List available prompts from the MCP server"""
+        if self._prompts_cache is None:
+            try:
+                result = await self._make_mcp_request("prompts/list")
+                self._prompts_cache = result.get("prompts", [])
+            except Exception:
+                # Some servers might not support prompts
+                self._prompts_cache = []
+        return self._prompts_cache
+
+    async def get_prompt(
+        self, name: str, arguments: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        """Get a prompt from the MCP server"""
+        params = {"name": name}
+        if arguments:
+            params["arguments"] = arguments
+
+        result = await self._make_mcp_request("prompts/get", params)
+        return result
+
+    def run(self, arguments):
+        """
+        Main run method for the tool.
+        Supports different operations based on the 'operation' argument.
+        """
+        operation = arguments.get("operation", "call_tool")
+
+        async def _run_async():
+            try:
+                if operation == "list_tools":
+                    return await self._run_list_tools()
+                elif operation == "call_tool":
+                    return await self._run_call_tool(arguments)
+                elif operation == "list_resources":
+                    return await self._run_list_resources()
+                elif operation == "read_resource":
+                    return await self._run_read_resource(arguments)
+                elif operation == "list_prompts":
+                    return await self._run_list_prompts()
+                elif operation == "get_prompt":
+                    return await self._run_get_prompt(arguments)
+                else:
+                    return {"error": f"Unknown operation: {operation}"}
+            except Exception as e:
+                return {"error": str(e)}
+            finally:
+                # Always clean up session
+                await self._close_session()
+
+        return self._run_with_cleanup(_run_async)
+
+    async def _run_list_tools(self):
+        """Run list_tools operation"""
+        tools = await self.list_tools()
+        return {"tools": tools}
+
+    async def _run_call_tool(self, arguments):
+        """Run call_tool operation"""
+        tool_name = arguments.get("tool_name")
+        tool_arguments = arguments.get("tool_arguments", {})
+
+        if not tool_name:
+            return {"error": "tool_name is required for call_tool operation"}
+
+        result = await self.call_tool(tool_name, tool_arguments)
+        return result
+
+    async def _run_list_resources(self):
+        """Run list_resources operation"""
+        resources = await self.list_resources()
+        return {"resources": resources}
+
+    async def _run_read_resource(self, arguments):
+        """Run read_resource operation"""
+        uri = arguments.get("uri")
+
+        if not uri:
+            return {"error": "uri is required for read_resource operation"}
+
+        result = await self.read_resource(uri)
+        return result
+
+    async def _run_list_prompts(self):
+        """Run list_prompts operation"""
+        prompts = await self.list_prompts()
+        return {"prompts": prompts}
+
+    async def _run_get_prompt(self, arguments):
+        """Run get_prompt operation"""
+        prompt_name = arguments.get("prompt_name")
+        prompt_arguments = arguments.get("prompt_arguments", {})
+
+        if not prompt_name:
+            return {"error": "prompt_name is required for get_prompt operation"}
+
+        result = await self.get_prompt(prompt_name, prompt_arguments)
+        return result
+
+
+@register_tool("MCPProxyTool")
+class MCPProxyTool(MCPClientTool):
+    """
+    A proxy tool that automatically forwards tool calls to an MCP server.
+    This creates individual tools for each tool available on the MCP server.
+    """
+
+    def __init__(self, tool_config):
+        super().__init__(tool_config)
+        self.target_tool_name = tool_config.get("target_tool_name")
+        if not self.target_tool_name:
+            raise ValueError("MCPProxyTool requires 'target_tool_name' in tool_config")
+
+    def run(self, arguments):
+        """Forward the call directly to the target tool on the MCP server"""
+
+        async def _run_async():
+            try:
+                result = await self.call_tool(self.target_tool_name, arguments)
+                return result
+            except Exception as e:
+                return {"error": str(e)}
+            finally:
+                # Always clean up session
+                await self._close_session()
+
+        return self._run_with_cleanup(_run_async)
+
+
+@register_tool("MCPServerDiscovery")
+class MCPServerDiscovery:
+    """
+    Helper class to discover and create tool configurations for MCP servers.
+    """
+
+    @staticmethod
+    async def discover_server_tools(
+        server_url: str, transport: str = "http"
+    ) -> List[Dict[str, Any]]:
+        """
+        Discover all tools available on an MCP server and return tool configurations.
+        """
+        # Create a temporary client to discover tools
+        temp_config = {
+            "server_url": server_url,
+            "transport": transport,
+            "name": "temp_discovery",
+            "description": "Temporary tool for discovery",
+        }
+
+        client = MCPClientTool(temp_config)
+
+        try:
+            # Get available tools
+            tools = await client.list_tools()
+
+            # Create tool configurations for each discovered tool
+            tool_configs = []
+
+            for tool in tools:
+                tool_name = tool.get("name", "unknown_tool")
+                tool_description = tool.get(
+                    "description", f"Tool {tool_name} from MCP server"
+                )
+
+                # Create a configuration for this specific tool
+                config = {
+                    "name": f"mcp_{tool_name}",
+                    "description": tool_description,
+                    "type": "MCPProxyTool",
+                    "server_url": server_url,
+                    "transport": transport,
+                    "target_tool_name": tool_name,
+                    "parameter": {
+                        "type": "object",
+                        "properties": tool.get("inputSchema", {}).get("properties", {}),
+                        "required": tool.get("inputSchema", {}).get("required", []),
+                    },
+                }
+
+                tool_configs.append(config)
+
+            return tool_configs
+
+        except Exception as e:
+            print(f"Error discovering tools from MCP server {server_url}: {e}")
+            return []
+        finally:
+            await client._close_session()
+
+    @staticmethod
+    def create_mcp_tools_config(
+        server_configs: List[Dict[str, str]],
+    ) -> List[Dict[str, Any]]:
+        """
+        Create tool configurations for multiple MCP servers.
+
+        Args:
+            server_configs: List of server configurations, each containing:
+                - server_url: URL of the MCP server
+                - transport: 'http' or 'websocket' (optional, defaults to 'http')
+                - server_name: Name prefix for tools (optional)
+
+        Returns:
+            List of tool configurations that can be loaded into ToolUniverse
+        """
+        all_configs = []
+
+        for server_config in server_configs:
+            server_url = server_config["server_url"]
+            transport = server_config.get("transport", "http")
+            server_name = server_config.get("server_name", "mcp_server")
+
+            # Create a generic MCP client tool for this server
+            client_config = {
+                "name": f"{server_name}_client",
+                "description": f"MCP client for server at {server_url}",
+                "type": "MCPClientTool",
+                "server_url": server_url,
+                "transport": transport,
+                "parameter": {
+                    "type": "object",
+                    "properties": {
+                        "operation": {
+                            "type": "string",
+                            "enum": [
+                                "list_tools",
+                                "call_tool",
+                                "list_resources",
+                                "read_resource",
+                                "list_prompts",
+                                "get_prompt",
+                            ],
+                            "description": "The MCP operation to perform",
+                        },
+                        "tool_name": {
+                            "type": "string",
+                            "description": "Name of the tool to call (required for call_tool operation)",
+                        },
+                        "tool_arguments": {
+                            "type": "object",
+                            "description": "Arguments to pass to the tool (for call_tool operation)",
+                        },
+                        "uri": {
+                            "type": "string",
+                            "description": "Resource URI (required for read_resource operation)",
+                        },
+                        "prompt_name": {
+                            "type": "string",
+                            "description": "Name of the prompt to get (required for get_prompt operation)",
+                        },
+                        "prompt_arguments": {
+                            "type": "object",
+                            "description": "Arguments to pass to the prompt (for get_prompt operation)",
+                        },
+                    },
+                    "required": ["operation"],
+                },
+            }
+
+            all_configs.append(client_config)
+
+        return all_configs
+
+
+@register_tool("MCPAutoLoaderTool")
+class MCPAutoLoaderTool(BaseTool, BaseMCPClient):
+    """
+    An advanced MCP tool that automatically discovers and loads all tools from an MCP server.
+    It can register discovered tools as individual ToolUniverse tools for seamless usage.
+    """
+
+    def __init__(self, tool_config):
+        BaseTool.__init__(self, tool_config)
+        BaseMCPClient.__init__(
+            self,
+            server_url=tool_config.get("server_url", "http://localhost:8000"),
+            transport=tool_config.get("transport", "http"),
+            timeout=tool_config.get("timeout", 5),
+        )
+
+        self.auto_register = tool_config.get("auto_register", True)
+        self.tool_prefix = tool_config.get("tool_prefix", "mcp_")
+        self.selected_tools = tool_config.get(
+            "selected_tools", None
+        )  # None means load all
+
+        # Debug logging
+        print(
+            f"MCPAutoLoaderTool '{tool_config.get('name', 'Unknown')}' initialized with:"
+        )
+        print(f"  - server_url: {self.server_url}")
+        print(f"  - transport: {self.transport}")
+        print(f"  - auto_register: {self.auto_register}")
+        print(f"  - tool_prefix: {self.tool_prefix}")
+        print(f"  - selected_tools: {self.selected_tools}")
+        print(f"  - timeout: {self.timeout}")
+
+        self._discovered_tools = {}
+        self._registered_tools = {}
+
+    async def discover_tools(self) -> Dict[str, Any]:
+        """Discover all available tools from the MCP server"""
+        try:
+            await self._initialize_mcp_session()
+            tools_response = await self._make_mcp_request("tools/list")
+            tools = tools_response.get("tools", [])
+
+            self._discovered_tools = {}
+            for tool in tools:
+                tool_name = tool.get("name")
+                if tool_name:
+                    self._discovered_tools[tool_name] = tool
+
+            return self._discovered_tools
+        except Exception as e:
+            raise Exception(f"Failed to discover tools: {str(e)}")
+
+    async def call_tool(
+        self, tool_name: str, arguments: Dict[str, Any]
+    ) -> Dict[str, Any]:
+        """Directly call an MCP tool by name"""
+        try:
+            params = {"name": tool_name, "arguments": arguments}
+
+            result = await self._make_mcp_request("tools/call", params)
+            return result
+        except Exception as e:
+            raise Exception(f"Failed to call tool {tool_name}: {str(e)}")
+
+    def generate_proxy_tool_configs(self) -> List[Dict[str, Any]]:
+        """Generate proxy tool configurations for discovered tools"""
+        configs = []
+
+        for tool_name, tool_info in self._discovered_tools.items():
+            # Skip if selected_tools is specified and this tool is not in it
+            if self.selected_tools and tool_name not in self.selected_tools:
+                continue
+
+            proxy_name = f"{self.tool_prefix}{tool_name}"
+
+            config = {
+                "name": proxy_name,
+                "description": tool_info.get(
+                    "description", f"Auto-loaded MCP tool: {tool_name}"
+                ),
+                "type": "MCPProxyTool",
+                "server_url": self.server_url,
+                "transport": self.transport,
+                "target_tool_name": tool_name,
+                "parameter": tool_info.get(
+                    "inputSchema", {"type": "object", "properties": {}, "required": []}
+                ),
+            }
+
+            configs.append(config)
+
+        return configs
+
+    def register_tools_in_engine(self, engine):
+        """Register discovered tools directly in the ToolUniverse engine"""
+        try:
+            configs = self.generate_proxy_tool_configs()
+
+            for config in configs:
+                # Add configuration to engine's all_tools list for validation
+                engine.all_tools.append(config)
+
+                # Create MCPProxyTool instance for execution
+                proxy_tool = MCPProxyTool(config)
+
+                # Register both config (for validation) and tool instance (for execution)
+                tool_name = config["name"]
+                engine.all_tool_dict[tool_name] = config  # For validation
+                engine.callable_functions[tool_name] = proxy_tool  # For execution
+                self._registered_tools[tool_name] = proxy_tool
+
+            return len(configs)
+        except Exception as e:
+            raise Exception(f"Failed to register tools: {str(e)}")
+
+    async def auto_load_and_register(self, engine) -> Dict[str, Any]:
+        """Automatically discover, load and register all MCP tools"""
+        try:
+            # Discover tools
+            discovered = await self.discover_tools()
+
+            print(
+                f"🔍 MCPAutoLoaderTool discovered {len(discovered)} tools from MCP server:"
+            )
+            for tool_name, tool_info in discovered.items():
+                print(
+                    f"  📋 {tool_name}: {tool_info.get('description', 'No description')}"
+                )
+
+            # Register tools if auto_register is enabled
+            if self.auto_register:
+                registered_count = self.register_tools_in_engine(engine)
+
+                print(
+                    f"✅ MCPAutoLoaderTool registered {registered_count} tools with prefix '{self.tool_prefix}':"
+                )
+                for registered_name in self._registered_tools.keys():
+                    print(f"  🔧 {registered_name}")
+
+                return {
+                    "discovered_count": len(discovered),
+                    "registered_count": registered_count,
+                    "tools": list(discovered.keys()),
+                    "registered_tools": list(self._registered_tools.keys()),
+                }
+            else:
+                print(
+                    "ℹ️  MCPAutoLoaderTool auto_register is disabled. Tools not registered automatically."
+                )
+                return {
+                    "discovered_count": len(discovered),
+                    "tools": list(discovered.keys()),
+                    "configs": self.generate_proxy_tool_configs(),
+                }
+        except Exception as e:
+            print(f"❌ MCPAutoLoaderTool auto-load failed: {str(e)}")
+            raise Exception(f"Auto-load failed: {str(e)}")
+
+    def run(self, arguments):
+        """Main run method for the auto-loader tool"""
+        operation = arguments.get("operation")
+
+        async def _run_async():
+            try:
+                if operation == "discover":
+                    # Discover available tools
+                    discovered = await self.discover_tools()
+                    return {
+                        "discovered_count": len(discovered),
+                        "tools": list(discovered.keys()),
+                        "tool_details": discovered,
+                    }
+
+                elif operation == "generate_configs":
+                    # Generate proxy tool configurations
+                    if not self._discovered_tools:
+                        # Need to discover first
+                        await self.discover_tools()
+
+                    configs = self.generate_proxy_tool_configs()
+                    return {"configs": configs, "count": len(configs)}
+
+                elif operation == "call_tool":
+                    # Directly call an MCP tool
+                    tool_name = arguments.get("tool_name")
+                    tool_arguments = arguments.get("tool_arguments", {})
+
+                    if not tool_name:
+                        raise ValueError(
+                            "tool_name is required for call_tool operation"
+                        )
+
+                    result = await self.call_tool(tool_name, tool_arguments)
+                    return result
+
+                else:
+                    raise ValueError(f"Unsupported operation: {operation}")
+            finally:
+                # Always clean up session
+                await self._close_session()
+
+        return self._run_with_cleanup(_run_async)
+
+    def __del__(self):
+        """Cleanup when object is destroyed"""
+        if (
+            hasattr(self, "session")
+            and self.session
+            and hasattr(self.session, "_connector")
+        ):
+            # Suppress ResourceWarnings during cleanup
+            with warnings.catch_warnings():
+                warnings.simplefilter("ignore", ResourceWarning)
+                try:
+                    # Try to get the current loop
+                    try:
+                        loop = asyncio.get_running_loop()
+                        # Schedule cleanup in the current loop
+                        loop.create_task(self._close_session())
+                    except RuntimeError:
+                        # No running loop, create a new one for cleanup
+                        loop = asyncio.new_event_loop()
+                        asyncio.set_event_loop(loop)
+                        try:
+                            loop.run_until_complete(self._close_session())
+                        finally:
+                            loop.close()
+                except Exception:
+                    # If all else fails, just set session to None
+                    self.session = None