feat: connection manager related tool (#90)

* feat: connection manager related tool

* fix: logging은 base.py에서 수행하도록 수정

Author: choieastsea

.gitignore

@@ -194,3 +194,6 @@ cython_debug/
 #  refer to https://docs.cursor.com/context/ignore-files
 .cursorignore
 .cursorindexingignore
+
+# Openstack Config Files
+clouds.yaml

src/openstack_mcp_server/tools/__init__.py

@@ -1,5 +1,7 @@
 from fastmcp import FastMCP
 
+from openstack_mcp_server.tools.connection import ConnectionManager
+
 
 def register_tool(mcp: FastMCP):
     """
@@ -17,3 +19,4 @@ def register_tool(mcp: FastMCP):
     IdentityTools().register_tools(mcp)
     NetworkTools().register_tools(mcp)
     BlockStorageTools().register_tools(mcp)
+    ConnectionManager().register_tools(mcp)

src/openstack_mcp_server/tools/base.py

@@ -1,27 +1,21 @@
 import openstack
 
-from openstack import connection
-
 from openstack_mcp_server import config
+from openstack_mcp_server.tools.connection import ConnectionManager
+
 
+_connection_manager = ConnectionManager()
 
-class OpenStackConnectionManager:
-    """OpenStack Connection Manager"""
+openstack.enable_logging(debug=config.MCP_DEBUG_MODE)
 
-    _connection: connection.Connection | None = None
 
-    @classmethod
-    def get_connection(cls) -> connection.Connection:
-        """OpenStack Connection"""
-        if cls._connection is None:
-            openstack.enable_logging(debug=config.MCP_DEBUG_MODE)
-            cls._connection = openstack.connect(cloud=config.MCP_CLOUD_NAME)
-        return cls._connection
+def get_openstack_conn():
+    return _connection_manager.get_connection()
 
 
-_openstack_connection_manager = OpenStackConnectionManager()
+def set_openstack_cloud_name(cloud_name: str) -> None:
+    _connection_manager.set_cloud_name(cloud_name)
 
 
-def get_openstack_conn():
-    """Get OpenStack Connection"""
-    return _openstack_connection_manager.get_connection()
+def get_openstack_cloud_name() -> str:
+    return _connection_manager.get_cloud_name()

src/openstack_mcp_server/tools/connection.py

@@ -0,0 +1,70 @@
+import openstack
+
+from fastmcp import FastMCP
+from openstack import connection
+from openstack.config.loader import OpenStackConfig
+
+from openstack_mcp_server import config
+
+
+class ConnectionManager:
+    _cloud_name = config.MCP_CLOUD_NAME
+
+    def register_tools(self, mcp: FastMCP):
+        mcp.tool(self.get_cloud_config)
+        mcp.tool(self.get_cloud_names)
+        mcp.tool(self.get_cloud_name)
+        mcp.tool(self.set_cloud_name)
+
+    def get_connection(self) -> connection.Connection:
+        return openstack.connect(cloud=self._cloud_name)
+
+    def get_cloud_names(self) -> list[str]:
+        """List available cloud configurations.
+
+        :return: Names of OpenStack clouds from user's config file.
+        """
+        config = OpenStackConfig()
+        return list(config.get_cloud_names())
+
+    def get_cloud_config(self) -> dict:
+        """Provide cloud configuration with secrets masked of current user's config file.
+
+        :return: Cloud configuration dictionary with credentials masked.
+        """
+        config = OpenStackConfig()
+        return ConnectionManager._mask_credential(
+            config.cloud_config, ["password"]
+        )
+
+    @staticmethod
+    def _mask_credential(
+        config_dict: dict, credential_keys: list[str]
+    ) -> dict:
+        masked = {}
+        for k, v in config_dict.items():
+            if k in credential_keys:
+                masked[k] = "****"
+            elif isinstance(v, dict):
+                masked[k] = ConnectionManager._mask_credential(
+                    v, credential_keys
+                )
+            else:
+                masked[k] = v
+        return masked
+
+    @classmethod
+    def get_cloud_name(cls) -> str:
+        """Return the currently selected cloud name.
+
+        :return: current OpenStack cloud name.
+        """
+        return cls._cloud_name
+
+    @classmethod
+    def set_cloud_name(cls, cloud_name: str) -> None:
+        """Set cloud name to use for later connections. Must set name from currently valid cloud config file.
+
+        :param cloud_name: Name of the OpenStack cloud profile to activate.
+        """
+        cls._cloud_name = cloud_name