Update documentation and fix MCP plugin

.github/workflows/test.yml

@@ -12,7 +12,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13"]
 
     steps:
     - uses: actions/checkout@v4

README.md

@@ -68,7 +68,7 @@ git clone https://github.com/universal-tool-calling-protocol/python-utcp.git
 cd python-utcp
 
 # Install the core package in editable mode with dev dependencies
-pip install -e core[dev]
+pip install -e "core[dev]"
 
 # Install a specific protocol plugin in editable mode
 pip install -e plugins/communication_protocols/http

core/src/utcp/__init__.py

@@ -3,7 +3,7 @@
 
 logger = logging.getLogger("utcp")
 
-if not logger.handlers:  # Only add default handler if user didn't configure logging
+if not logger.hasHandlers():  # Only add default handler if user didn't configure logging
     handler = logging.StreamHandler(sys.stderr)
     handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d - %(message)s"))
     logger.addHandler(handler)

core/src/utcp/implementations/utcp_client_implementation.py

@@ -110,7 +110,7 @@ async def register_manual(self, manual_call_template: CallTemplate) -> RegisterM
             raise ValueError(f"No registered communication protocol of type {manual_call_template.call_template_type} found, available types: {CommunicationProtocol.communication_protocols.keys()}")
 
         result = await CommunicationProtocol.communication_protocols[manual_call_template.call_template_type].register_manual(self, manual_call_template)
-        
+
         if result.success:
             for tool in result.manual.tools:
                 if not tool.name.startswith(manual_call_template.name + "."):

plugins/communication_protocols/cli/src/utcp_cli/cli_communication_protocol.py

@@ -23,6 +23,7 @@
 import json
 import os
 import shlex
+import sys
 from typing import Dict, Any, List, Optional, Callable, AsyncGenerator
 
 from utcp.interfaces.communication_protocol import CommunicationProtocol
@@ -35,6 +36,12 @@
 
 logger = logging.getLogger(__name__)
 
+if not logger.hasHandlers():  # Only add default handler if user didn't configure logging
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d - %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
 
 class CliCommunicationProtocol(CommunicationProtocol):
     """REQUIRED

plugins/communication_protocols/gql/src/utcp_gql/gql_communication_protocol.py

@@ -1,3 +1,4 @@
+import sys
 from typing import Dict, Any, List, Optional, Callable
 import aiohttp
 import asyncio
@@ -12,6 +13,13 @@
 
 logger = logging.getLogger(__name__)
 
+if not logger.hasHandlers():  # Only add default handler if user didn't configure logging
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d - %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
+
 class GraphQLClientTransport(ClientTransportInterface):
     """
     Simple, robust, production-ready GraphQL transport using gql.

plugins/communication_protocols/http/src/utcp_http/http_communication_protocol.py

@@ -12,6 +12,7 @@
     - Request/response handling with proper error management
 """
 
+import sys
 from typing import Dict, Any, List, Optional, Callable, AsyncGenerator
 import aiohttp
 import json
@@ -36,6 +37,12 @@
 
 logger = logging.getLogger(__name__)
 
+if not logger.hasHandlers():  # Only add default handler if user didn't configure logging
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d - %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
 class HttpCommunicationProtocol(CommunicationProtocol):
     """REQUIRED
     HTTP communication protocol implementation for UTCP client.

plugins/communication_protocols/http/src/utcp_http/sse_communication_protocol.py

@@ -1,3 +1,4 @@
+import sys
 from typing import Dict, Any, List, Optional, Callable, AsyncIterator, AsyncGenerator
 import aiohttp
 import json
@@ -21,6 +22,12 @@
 
 logger = logging.getLogger(__name__)
 
+if not logger.hasHandlers():  # Only add default handler if user didn't configure logging
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d - %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
 class SseCommunicationProtocol(CommunicationProtocol):
     """REQUIRED
     SSE communication protocol implementation for UTCP client.

plugins/communication_protocols/http/src/utcp_http/streamable_http_communication_protocol.py

@@ -1,3 +1,4 @@
+import sys
 from typing import Dict, Any, List, Optional, Callable, AsyncIterator, Tuple, AsyncGenerator
 import aiohttp
 import json
@@ -18,6 +19,12 @@
 
 logger = logging.getLogger(__name__)
 
+if not logger.hasHandlers():  # Only add default handler if user didn't configure logging
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d - %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
 class StreamableHttpCommunicationProtocol(CommunicationProtocol):
     """REQUIRED
     Streamable HTTP communication protocol implementation for UTCP client.

plugins/communication_protocols/mcp/pyproject.toml

@@ -10,11 +10,12 @@ authors = [
 ]
 description = "UTCP communication protocol plugin for interoperability with the Model Context Protocol (MCP)."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "pydantic>=2.0",
     "mcp>=1.12",
-    "utcp>=1.0"
+    "utcp>=1.0",
+    "mcp-use>=1.3"
 ]
 classifiers = [
     "Development Status :: 4 - Beta",

plugins/communication_protocols/mcp/src/utcp_mcp/mcp_call_template.py

@@ -42,11 +42,15 @@ class McpCallTemplate(CallTemplate):
         config: Configuration object containing MCP server definitions.
             This follows the same format as the official MCP server configuration.
         auth: Optional OAuth2 authentication for HTTP-based MCP servers.
+        register_resources_as_tools: Whether to register MCP resources as callable tools.
+            When True, server resources are exposed as tools that can be called.
+            Default is False.
     """
 
     call_template_type: Literal["mcp"] = "mcp"
     config: McpConfig
     auth: Optional[OAuth2Auth] = None
+    register_resources_as_tools: bool = False
 
 class McpCallTemplateSerializer(Serializer[McpCallTemplate]):
     """REQUIRED