microsoft-agents-a365-tooling-extensions-semantickernel 0.1.0__py3-none-any.whl

microsoft_agents_a365/tooling/extensions/semantickernel/__init__.py

@@ -0,0 +1,17 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+"""
+Semantic Kernel extensions for Microsoft Agent 365 Tooling SDK
+
+Tooling and utilities specifically for Semantic Kernel framework integration.
+Provides Semantic Kernel-specific helper utilities.
+"""
+
+from .services import McpToolRegistrationService
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "McpToolRegistrationService",
+]

microsoft_agents_a365/tooling/extensions/semantickernel/services/__init__.py

@@ -0,0 +1,14 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""
+Services module for Semantic Kernel tooling.
+
+This package contains service implementations for MCP tool registration
+and management within the Semantic Kernel framework.
+"""
+
+from .mcp_tool_registration_service import McpToolRegistrationService
+
+__all__ = [
+    "McpToolRegistrationService",
+]

microsoft_agents_a365/tooling/extensions/semantickernel/services/mcp_tool_registration_service.py

@@ -0,0 +1,228 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""
+MCP Tool Registration Service implementation for Semantic Kernel.
+
+This module provides the concrete implementation of the MCP (Model Context Protocol)
+tool registration service that integrates with Semantic Kernel to add MCP tool
+servers to agents.
+"""
+
+# Standard library imports
+import logging
+import os
+import re
+from typing import Any, Optional
+from semantic_kernel import kernel as sk
+from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin
+from microsoft_agents.hosting.core import Authorization, TurnContext
+from microsoft_agents_a365.runtime.utility import Utility
+from microsoft_agents_a365.tooling.services.mcp_tool_server_configuration_service import (
+    McpToolServerConfigurationService,
+)
+from microsoft_agents_a365.tooling.models.mcp_server_config import MCPServerConfig
+from microsoft_agents_a365.tooling.utils.constants import Constants
+from microsoft_agents_a365.tooling.utils.utility import (
+    get_tools_mode,
+    get_mcp_platform_authentication_scope,
+)
+
+
+class McpToolRegistrationService:
+    """
+    Provides services related to tools in the Semantic Kernel.
+
+    This service handles registration and management of MCP (Model Context Protocol)
+    tool servers with Semantic Kernel agents.
+    """
+
+    def __init__(
+        self,
+        logger: Optional[logging.Logger] = None,
+    ):
+        """
+        Initialize the MCP Tool Registration Service for Semantic Kernel.
+
+        Args:
+            logger: Logger instance for logging operations.
+        """
+        self._logger = logger or logging.getLogger(self.__class__.__name__)
+        self._mcp_server_configuration_service = McpToolServerConfigurationService(
+            logger=self._logger
+        )
+
+        # Store connected plugins to keep them alive
+        self._connected_plugins = []
+
+        # Enable debug logging if configured
+        if os.getenv("MCP_DEBUG_LOGGING", "false").lower() == "true":
+            self._logger.setLevel(logging.DEBUG)
+
+        # Configure strict parameter validation (prevents dynamic property creation)
+        self._strict_parameter_validation = (
+            os.getenv("MCP_STRICT_PARAMETER_VALIDATION", "true").lower() == "true"
+        )
+        if self._strict_parameter_validation:
+            self._logger.info(
+                "🔒 Strict parameter validation enabled - only schema-defined parameters are allowed"
+            )
+        else:
+            self._logger.info(
+                "🔓 Strict parameter validation disabled - dynamic parameters are allowed"
+            )
+
+    # ============================================================================
+    # Public Methods
+    # ============================================================================
+
+    async def add_tool_servers_to_agent(
+        self,
+        kernel: sk.Kernel,
+        auth: Authorization,
+        auth_handler_name: str,
+        context: TurnContext,
+        auth_token: Optional[str] = None,
+    ) -> None:
+        """
+        Adds the A365 MCP Tool Servers to the specified kernel.
+
+        Args:
+            kernel: The Semantic Kernel instance to which the tools will be added.
+            auth: Authorization handler for token exchange.
+            auth_handler_name: Name of the authorization handler.
+            context: Turn context for the current operation.
+            auth_token: Authentication token to access the MCP servers.
+
+        Raises:
+            ValueError: If kernel is None or required parameters are invalid.
+            Exception: If there's an error connecting to or configuring MCP servers.
+        """
+
+        if not auth_token:
+            scopes = get_mcp_platform_authentication_scope()
+            authToken = await auth.exchange_token(context, scopes, auth_handler_name)
+            auth_token = authToken.token
+
+        agentic_app_id = Utility.resolve_agent_identity(context, auth_token)
+        self._validate_inputs(kernel, agentic_app_id, auth_token)
+
+        # Get and process servers
+        servers = await self._mcp_server_configuration_service.list_tool_servers(
+            agentic_app_id, auth_token
+        )
+        self._logger.info(f"🔧 Adding MCP tools from {len(servers)} servers")
+
+        # Get tools mode
+        tools_mode = get_tools_mode()
+
+        # Process each server (matching C# foreach pattern)
+        for server in servers:
+            try:
+                if tools_mode == "HardCodedTools":
+                    await self._add_hardcoded_tools_for_server(kernel, server)
+                    continue
+
+                headers = {}
+
+                if tools_mode == "MockMCPServer":
+                    if mock_auth_header := os.getenv("MOCK_MCP_AUTHORIZATION"):
+                        headers[Constants.Headers.AUTHORIZATION] = mock_auth_header
+                else:
+                    headers = {
+                        Constants.Headers.AUTHORIZATION: f"{Constants.Headers.BEARER_PREFIX} {auth_token}",
+                    }
+
+                plugin = MCPStreamableHttpPlugin(
+                    name=server.mcp_server_name,
+                    url=server.mcp_server_unique_name,
+                    headers=headers or None,
+                )
+
+                # Connect the plugin
+                await plugin.connect()
+
+                # Add plugin to kernel
+                kernel.add_plugin(plugin, server.mcp_server_name)
+
+                # Store reference to keep plugin alive throughout application lifecycle
+                # By storing plugin references in _connected_plugins, we prevent Python's garbage collector from cleaning up the plugin objects
+                # The connections remain active throughout the application lifecycle
+                # Tools can be successfully invoked because their underlying connections are still alive
+                self._connected_plugins.append(plugin)
+
+                self._logger.info(
+                    f"✅ Connected and added MCP plugin ({tools_mode}) for: {server.mcp_server_name}"
+                )
+
+            except Exception as e:
+                self._logger.error(f"Failed to add tools from {server.mcp_server_name}: {str(e)}")
+
+        self._logger.info("✅ Successfully configured MCP tool servers for the agent!")
+
+    # ============================================================================
+    # Private Methods - Input Validation & Processing
+    # ============================================================================
+
+    def _validate_inputs(self, kernel: Any, agentic_app_id: str, auth_token: str) -> None:
+        """Validate all required inputs."""
+        if kernel is None:
+            raise ValueError("kernel cannot be None")
+        if not agentic_app_id or not agentic_app_id.strip():
+            raise ValueError("agentic_app_id cannot be null or empty")
+        if not auth_token or not auth_token.strip():
+            raise ValueError("auth_token cannot be null or empty")
+
+    async def _add_hardcoded_tools_for_server(self, kernel: Any, server: MCPServerConfig) -> None:
+        """Add hardcoded tools for a specific server (equivalent to C# hardcoded tool logic)."""
+        server_name = server.mcp_server_name
+
+        if server_name.lower() == "mcp_mailtools":
+            # TODO: Implement hardcoded mail tools
+            # kernel.plugins.add(KernelPluginFactory.create_from_type(HardCodedMailTools, server.mcp_server_name, self._service_provider))
+            self._logger.info(f"Adding hardcoded mail tools for {server_name}")
+        elif server_name.lower() == "mcp_sharepointtools":
+            # TODO: Implement hardcoded SharePoint tools
+            # kernel.plugins.add(KernelPluginFactory.create_from_type(HardCodedSharePointTools, server.mcp_server_name, self._service_provider))
+            self._logger.info(f"Adding hardcoded SharePoint tools for {server_name}")
+        elif server_name.lower() == "onedrivemcpserver":
+            # TODO: Implement hardcoded OneDrive tools
+            # kernel.plugins.add(KernelPluginFactory.create_from_type(HardCodedOneDriveTools, server.mcp_server_name, self._service_provider))
+            self._logger.info(f"Adding hardcoded OneDrive tools for {server_name}")
+        elif server_name.lower() == "wordmcpserver":
+            # TODO: Implement hardcoded Word tools
+            # kernel.plugins.add(KernelPluginFactory.create_from_type(HardCodedWordTools, server.mcp_server_name, self._service_provider))
+            self._logger.info(f"Adding hardcoded Word tools for {server_name}")
+        else:
+            self._logger.warning(f"No hardcoded tools available for server: {server_name}")
+
+    # ============================================================================
+    # Private Methods - Kernel Function Creation
+    # ============================================================================
+
+    def _get_plugin_name_from_server_name(self, server_name: str) -> str:
+        """Generate a clean plugin name from server name."""
+        clean_name = re.sub(r"[^a-zA-Z0-9_]", "_", server_name)
+        return f"{clean_name}Tools"
+
+    # ============================================================================
+    # Cleanup Methods
+    # ============================================================================
+
+    async def cleanup_connections(self) -> None:
+        """Clean up all connected MCP plugins."""
+        self._logger.info(f"🧹 Cleaning up {len(self._connected_plugins)} MCP plugin connections")
+
+        for plugin in self._connected_plugins:
+            try:
+                if hasattr(plugin, "close"):
+                    await plugin.close()
+                elif hasattr(plugin, "disconnect"):
+                    await plugin.disconnect()
+                self._logger.debug(
+                    f"✅ Closed connection for plugin: {getattr(plugin, 'name', 'unknown')}"
+                )
+            except Exception as e:
+                self._logger.warning(f"⚠️ Error closing plugin connection: {e}")
+
+        self._connected_plugins.clear()
+        self._logger.info("✅ All MCP plugin connections cleaned up")

microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/METADATA

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-tooling-extensions-semantickernel
+Version: 0.1.0
+Summary: Semantic Kernel integration for Agent 365 Tooling SDK
+Author-email: Microsoft <support@microsoft.com>
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agent365-python
+Project-URL: Repository, https://github.com/microsoft/Agent365-python
+Project-URL: Issues, https://github.com/microsoft/Agent365-python/issues
+Project-URL: Documentation, https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-tooling-extensions-semantickernel
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-tooling>=0.0.0
+Requires-Dist: semantic-kernel>=1.0.0
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+
+# microsoft-agents-a365-tooling-extensions-semantickernel
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-tooling-extensions-semantickernel?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-semantickernel)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-tooling-extensions-semantickernel?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-semantickernel)
+
+Semantic Kernel specific tools and services for AI agent development. Provides MCP (Model Context Protocol) tool registration service for dynamically adding MCP servers to Semantic Kernel-based agents.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-tooling-extensions-semantickernel
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Tooling documentation](https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+microsoft_agents_a365/tooling/extensions/semantickernel/__init__.py,sha256=IvWvvW3Yajk0vX0Il0zisWbN0F-2EIWBmSpAkTeEETw,398
+microsoft_agents_a365/tooling/extensions/semantickernel/services/__init__.py,sha256=uao2omD_YpBZJFqHuK-Lnk7Hy0d2_3blvZcXWI-1dRg,348
+microsoft_agents_a365/tooling/extensions/semantickernel/services/mcp_tool_registration_service.py,sha256=sxPzkg41K0FjE4UaoAWrYm91_1iYuMGsc1b5BoJ0R5I,10095
+microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/METADATA,sha256=Mgernpqhv7KB3t7r9elYUMCEe4_9SadGV2_dzJd1vFQ,3365
+microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/top_level.txt,sha256=G3c2_4sy5_EM_BWO67SbK2tKj4G8XFn-QXRbh8g9Lgk,22
+microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/RECORD,,

microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

microsoft_agents_a365_tooling_extensions_semantickernel-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+microsoft_agents_a365