fix(server): improve graceful shutdown and fix naming convention

- Rename server from "workflows" to "workflows_mcp" following Python MCP naming convention
- Add proper KeyboardInterrupt handling for graceful Ctrl+C shutdown
- Add detailed logging for server lifecycle events
- Fix WORKFLOWS_TEMPLATE_PATHS separator in README (colon to comma)

The shutdown improvements ensure proper cleanup of async resources
and lifespan context when server is stopped via SIGINT.

Author: ibacalu

README.md

@@ -53,7 +53,7 @@ The plugin automatically configures the MCP server with custom workflow director
         "--refresh"
       ],
       "env": {
-        "WORKFLOWS_TEMPLATE_PATHS": "~/.workflows:./.workflows",
+        "WORKFLOWS_TEMPLATE_PATHS": "~/.workflows,./.workflows",
         "WORKFLOWS_LOG_LEVEL": "INFO",
         "WORKFLOWS_MAX_RECURSION_DEPTH": "50"
       }

src/workflows_mcp/server.py

@@ -224,7 +224,8 @@ async def app_lifespan(_server: FastMCP) -> AsyncIterator[AppContext]:
 
 
 # Initialize MCP server with lifespan management
-mcp = FastMCP("workflows", lifespan=app_lifespan)
+# Following Python MCP naming convention: {service}_mcp
+mcp = FastMCP("workflows_mcp", lifespan=app_lifespan)
 
 
 # =============================================================================
@@ -265,8 +266,23 @@ def main() -> None:
         stream=sys.stderr,
     )
 
-    # Run the MCP server
-    mcp.run()  # Defaults to stdio transport
+    logger.info("Starting MCP server (press Ctrl+C to stop)...")
+
+    try:
+        # Run the MCP server with stdio transport
+        # anyio.run() (used internally by mcp.run()) handles SIGINT gracefully
+        # and raises KeyboardInterrupt for clean shutdown
+        mcp.run()
+    except KeyboardInterrupt:
+        # Graceful shutdown via Ctrl+C (SIGINT)
+        # anyio ensures proper cleanup of async resources and lifespan context
+        logger.info("Received interrupt signal, shutting down gracefully...")
+    except Exception as e:
+        # Unexpected errors
+        logger.exception(f"Server error: {e}")
+        sys.exit(1)
+
+    logger.info("Server shutdown complete")
 
 
 # =============================================================================