SD Elements MCP Server

Instructions

Implementation Reference

• src/sde_mcp_server/tools/projects.py:72-170 (handler)

  The core handler function for the 'create_project' MCP tool. Decorated with @mcp.tool() for automatic registration. Handles input validation via elicitation for missing name and profile_id, detects profile automatically if possible, constructs API payload, calls the SD Elements API to create the project, and returns JSON response.

  @mcp.tool()
  async def create_project(
      ctx: Context,
      application_id: int,
      name: Optional[str] = None,
      description: Optional[str] = None,
      phase_id: Optional[int] = None,
      profile_id: Optional[str] = None,
  ) -> str:
      """Create a new project in SD Elements. If name is not specified, prompts user to provide it. If profile is not specified, attempts to detect it from project name/description (e.g., 'mobile project' → Mobile profile). If detection fails, prompts user to select from available profiles."""
      global api_client
      if api_client is None:
          api_client = init_api_client()
      
      # Elicitation for name if not provided
      if not name:
          try:
              name_result = await asyncio.wait_for(
                  ctx.elicit(
                      "What is the name of the project you want to create?",
                      response_type=str
                  ),
                  timeout=ELICITATION_TIMEOUT
              )
              if name_result.action != "accept":
                  return json.dumps({"error": "Project creation cancelled: project name is required"})
              name = name_result.data
          except asyncio.TimeoutError:
              return json.dumps({"error": "Elicitation timeout: project name is required. Please provide the 'name' parameter."})
      
      # Elicitation for profile_id if not provided
      if not profile_id:
          profiles_response = api_client.list_profiles({"page_size": 1000})
          profiles = profiles_response.get("results", [])
          
          if not profiles:
              return json.dumps({"error": "No profiles available. Cannot create project without a profile."})
          
          # Try to detect profile from project name/description
          detected_profile_id = detect_profile_from_context(name, description or "", profiles)
          
          if detected_profile_id:
              # Profile detected automatically - use it
              profile_id = detected_profile_id
          else:
              # No profile detected - prompt user to select from available profiles
              profile_options = []
              profile_id_map = {}
              default_profile_id = None
              
              for profile in profiles:
                  profile_name_val = profile.get("name", "Unnamed Profile")
                  profile_id_val = profile.get("id")
                  profile_options.append(profile_name_val)
                  profile_id_map[profile_name_val] = profile_id_val
                  
                  # Track default profile to highlight it in the prompt
                  if profile.get("default", False):
                      default_profile_id = profile_id_val
              
              # Always prompt user to select a profile when detection fails
              prompt_message = "Select a profile:"
              if default_profile_id:
                  # Find default profile name for the prompt
                  default_profile_name = next(
                      (name for name, pid in profile_id_map.items() if pid == default_profile_id),
                      None
                  )
                  if default_profile_name:
                      prompt_message = f"Select a profile (default: {default_profile_name}):"
              
              try:
                  profile_result = await asyncio.wait_for(
                      ctx.elicit(prompt_message, response_type=profile_options),
                      timeout=ELICITATION_TIMEOUT
                  )
                  if profile_result.action != "accept":
                      return json.dumps({"error": "Project creation cancelled: profile selection is required"})
                  profile_id = profile_id_map.get(profile_result.data)
                  if not profile_id:
                      return json.dumps({"error": f"Could not find profile ID for selection: {profile_result.data}"})
              except asyncio.TimeoutError:
                  return json.dumps({"error": "Elicitation timeout: profile selection is required. Please provide the 'profile_id' parameter."})
      
      # Ensure profile_id is set - API requires it
      if not profile_id:
          return json.dumps({"error": "Profile is required but could not be determined. Please specify a profile_id."})
      
      data = {"name": name, "application": application_id}
      if description:
          data["description"] = description
      if phase_id:
          data["phase_id"] = phase_id
      # Profile is required, so always include it
      data["profile"] = profile_id
      
      result = api_client.create_project(data)
      return json.dumps(result, indent=2)