feat(mcp): enhance MCP server integration

- Add streamable HTTP and SSE transport apps for MCP server
- Update lifespan management to support both app types
- Modify mounting logic for improved compatibility

Author: MarkusNeusinger

.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "pyplots": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://api.pyplots.ai/sse/"]
+    }
+  }
+}

api/main.py

@@ -43,8 +43,11 @@
 logger = logging.getLogger(__name__)
 
 
-# Create MCP HTTP app (needed for lifespan integration)
-mcp_http_app = mcp_server.http_app(path="/mcp")
+# Create MCP HTTP apps (needed for lifespan integration)
+# Streamable HTTP (modern, recommended) - used by newer clients
+mcp_http_app = mcp_server.http_app(path="/")
+# SSE transport (legacy, wider compatibility) - used by mcp-remote, older clients
+mcp_sse_app = mcp_server.http_app(path="/", transport="sse")
 
 
 @asynccontextmanager
@@ -60,10 +63,11 @@ async def lifespan(app: FastAPI):
         except Exception as e:
             logger.error(f"Failed to initialize database: {e}")
 
-    # Initialize MCP server lifespan (required for session management)
+    # Initialize MCP server lifespans (required for session management)
     async with mcp_http_app.lifespan(app):
-        logger.info("MCP server initialized")
-        yield
+        async with mcp_sse_app.lifespan(app):
+            logger.info("MCP server initialized (HTTP + SSE)")
+            yield
 
     # Cleanup database connection
     logger.info("Shutting down pyplots API...")
@@ -132,9 +136,10 @@ async def add_cache_headers(request: Request, call_next):
     return response
 
 
-# Mount MCP server for AI assistant integration
-# Note: mcp_http_app is created earlier with lifespan integration
-app.mount("/mcp", mcp_http_app)
+# Mount MCP servers for AI assistant integration
+# Note: Apps are created earlier with lifespan integration
+app.mount("/mcp", mcp_http_app)  # Streamable HTTP at /mcp
+app.mount("/sse", mcp_sse_app)  # SSE transport at /sse
 
 # Register routers
 app.include_router(health_router)