feat(backend): add FastMCP framework support and handle missing package metadata

Add support for FastMCP Python framework in deployment validation and fix deployment failures for Python projects without pyproject.toml.

Changes:
- Add FastMCP package detection in runtime-detector.ts (requirements.txt and pyproject.toml)
- Generate fallback package name from repository name when metadata.name is undefined
- Handle Python projects with only requirements.txt (no pyproject.toml)
- Add logging when fallback package name generation is used

Author: Lasim

services/backend/src/lib/deployment/runtime-detector.ts

@@ -137,13 +137,28 @@ export class RuntimeDetector {
           line.trim() === 'mcp'
         );
 
+        // FastMCP framework (high-level MCP framework, 70% market share)
+        const fastmcpLine = requirements.find(line =>
+          line.trim().startsWith('fastmcp==') ||
+          line.trim().startsWith('fastmcp>=') ||
+          line.trim() === 'fastmcp'
+        );
+
+        // Prioritize official SDK, but FastMCP is also a valid MCP framework
         if (mcpLine) {
           mcpSdkInfo = {
             detected: true,
             version: mcpLine?.split(/==|>=/)[1]?.trim(),
             package: 'mcp',
             runtime: 'python'
           };
+        } else if (fastmcpLine) {
+          mcpSdkInfo = {
+            detected: true,
+            version: fastmcpLine?.split(/==|>=/)[1]?.trim(),
+            package: 'fastmcp',
+            runtime: 'python'
+          };
         }
       }
     } catch {
@@ -164,20 +179,32 @@ export class RuntimeDetector {
 
         // If we haven't found MCP SDK in requirements.txt, check pyproject.toml
         if (!mcpSdkInfo) {
-          // Check for "mcp" in dependencies (handles both "mcp" and "mcp>=1.0.0" formats)
+          // Check for official "mcp" SDK (handles both "mcp" and "mcp>=1.0.0" formats)
           const hasMcp = /["']mcp["']/.test(content) || /["']mcp[><=]/.test(content);
 
+          // Check for FastMCP framework
+          const hasFastmcp = /["']fastmcp["']/.test(content) || /["']fastmcp[><=]/.test(content);
+
           // Try to extract version from pyproject.toml if present
           // Matches patterns like "mcp>=1.0.0" or "mcp==1.0.0"
-          const versionMatch = content.match(/["']mcp[><=]=?\s*([^"',\]]+)["']/);
+          const mcpVersionMatch = content.match(/["']mcp[><=]=?\s*([^"',\]]+)["']/);
+          const fastmcpVersionMatch = content.match(/["']fastmcp[><=]=?\s*([^"',\]]+)["']/);
 
+          // Prioritize official SDK, but FastMCP is also a valid MCP framework
           if (hasMcp) {
             mcpSdkInfo = {
               detected: true,
-              version: versionMatch?.[1],
+              version: mcpVersionMatch?.[1],
               package: 'mcp',
               runtime: 'python'
             };
+          } else if (hasFastmcp) {
+            mcpSdkInfo = {
+              detected: true,
+              version: fastmcpVersionMatch?.[1],
+              package: 'fastmcp',
+              runtime: 'python'
+            };
           }
         }
 

services/backend/src/routes/teams/deploy/deploy.ts

@@ -508,22 +508,32 @@ export default async function deployRoutes(server: FastifyInstance) {
       // Extract validated metadata
       const { metadata } = repoValidationResult;
       const commitSha = metadata!.commit_sha;
-      const packageName = metadata!.name;
+      let packageName = metadata!.name;
       const packageVersion = metadata!.version;
       const packageDescription = metadata!.description;
       const packageLicense = metadata!.license;
       const runtime = metadata!.runtime;
 
+      // Parse GitHub URL early (needed for fallback and server creation)
+      const { owner, repo } = parseGitHubUrl(repository_url);
+
+      // Fallback: Generate package name from repository name if not present
+      // Common for Python projects with only requirements.txt (no pyproject.toml)
+      if (!packageName) {
+        packageName = repo; // e.g., "mcp-test-fastmcp"
+        request.log.info({
+          generatedPackageName: packageName,
+          source: 'repository_name'
+        }, 'Generated package name from repository (no pyproject.toml)');
+      }
+
       request.log.info({
         packageName,
         version: packageVersion,
         runtime,
         mcpSdkDetected: metadata!.mcp_sdk.detected
       }, 'Repository validated successfully');
 
-      // Parse GitHub URL for owner/repo (needed for server creation)
-      const { owner, repo } = parseGitHubUrl(repository_url);
-
       // ============================================
       // STEP 7: Create mcpServers Entry
       // ============================================