feat : mcp init (#1)

mcp server init

Author: halucinor

.gitignore

@@ -5,6 +5,7 @@ __pycache__/
 
 # C extensions
 *.so
+.idea
 
 # Distribution / packaging
 .Python

.python-version

@@ -0,0 +1 @@
+3.10

pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "python-openstackmcp-server"
+version = "0.1.0"
+description = "A MCP server providing OpenStack services for MCP clients"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli]>=1.12.0",
+    "openstacksdk>=4.6.0",
+    "pydantic>=2.11.7",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/openstack_mcp_server"]

src/openstack_mcp_server/__init__.py

@@ -0,0 +1,56 @@
+import sys
+import signal
+import argparse
+import logging
+
+# Configure root logger
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    handlers=[logging.StreamHandler(sys.stderr)]
+)
+logger = logging.getLogger("openstack-mcp-server")
+
+
+def handle_interrupt(signum, frame):
+    """Handle keyboard interrupt (Ctrl+C) gracefully."""
+    logger.info(f"Received signal {signum}, shutting down gracefully...")
+    sys.exit(0)
+
+
+def main():
+    """Openstack MCP Server main entry point."""
+    try:
+        # Import here to avoid circular imports
+        from openstack_mcp_server.config import MCP_TRANSPORT
+        from openstack_mcp_server.server import serve
+        parser = argparse.ArgumentParser(
+            description="Openstack MCP Server",
+        )
+
+        # Set up signal handler for graceful shutdown
+        signal.signal(signal.SIGINT, handle_interrupt)
+        signal.signal(signal.SIGTERM, handle_interrupt)
+
+        # Validate transport protocol
+        if MCP_TRANSPORT not in ["stdio", "sse", "streamable-http"]:
+            logger.error(
+                f"Invalid transport protocol: {MCP_TRANSPORT}. Using stdio instead.")
+            transport = "stdio"
+        else:
+            transport = MCP_TRANSPORT
+
+        # Start the server
+        logger.info(f"Starting Openstack MCP Server with {transport} transport")
+
+        args = parser.parse_args()
+
+        serve(transport=transport, **vars(args))
+
+    except KeyboardInterrupt:
+        logger.info("Keyboard interrupt received. Shutting down gracefully...")
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

src/openstack_mcp_server/__main__.py

@@ -0,0 +1,3 @@
+from openstack_mcp_server import main
+
+main()

src/openstack_mcp_server/config.py

@@ -0,0 +1,8 @@
+import os
+from pathlib import Path
+
+# Transport protocol
+MCP_TRANSPORT = os.environ.get("TRANSPORT", "stdio")
+
+# Application paths
+BASE_DIR = Path(__file__).parent.parent.parent

src/openstack_mcp_server/prompts/__init__.py

@@ -0,0 +1,19 @@
+from mcp.server.fastmcp import FastMCP
+from openstack_mcp_server.tools import register_tool
+
+def serve(transport: str, **kwargs):
+    """Serve the MCP server with the specified transport."""
+    mcp = FastMCP("openstack_mcp_server")
+
+    register_tool(mcp)
+    # resister_resources(mcp)
+    # register_prompt(mcp)
+
+    if transport == "stdio":
+        mcp.run(transport="stdio", **kwargs)
+    elif transport == "streamable-http":
+        mcp.run(transport="streamable-http", **kwargs)
+    elif transport == "sse":
+        mcp.run(transport="sse", **kwargs)
+    else:
+        raise ValueError(f"Unsupported transport: {transport}")

src/openstack_mcp_server/resources/__init__.py

@@ -0,0 +1,9 @@
+from mcp.server.fastmcp import FastMCP
+
+def register_tool(mcp : FastMCP):
+    """
+    Register Openstack MCP tools.
+    """
+    from .nova_tools import NovaTools
+
+    NovaTools().register_tools(mcp)