mcpxcodebuild

Instructions

Implementation Reference

• src/mcpxcodebuild/server.py:83-121 (handler)

  The main handler function for the 'build' tool (and 'test'). It changes to the specified folder, finds the Xcode project/workspace, determines the scheme and simulator, constructs the xcodebuild command, runs it, and returns the command and result summary (errors/warnings or success).
  @server.call_tool() async def call_tool(name, arguments: dict) -> list[TextContent]: try: args = Folder(**arguments) except ValueError as e: raise McpError(ErrorData(code=INVALID_PARAMS, message=str(e))) os.chdir(args.folder) xcode_project_path = find_xcode_project() project_name = os.path.basename(xcode_project_path) project_type = "" if xcode_project_path.endswith(".xcworkspace"): project_type = "-workspace" else: project_type = "-project" scheme = find_scheme(project_type, project_name) destination = find_available_simulator() command = ["xcodebuild", project_type, project_name, "-scheme", scheme, "-destination", destination] if name == "test": command.append("test") result = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False).stdout lines = result.decode("utf-8").splitlines() error_lines = [line for line in lines if "error:" or "warning:" in line.lower()] error_message = "\n".join(error_lines) if not error_message: error_message = "Successful" return [ TextContent(type="text", text=f"Command: {' '.join(command)}"), TextContent(type="text", text=f"{error_message}") ]
• src/mcpxcodebuild/server.py:63-65 (schema)

  Pydantic BaseModel defining the input parameters for the 'build' tool: the folder path containing the Xcode project/workspace.
  class Folder(BaseModel): """Parameters""" folder: Annotated[str, Field(description="The full path of the current folder that the iOS Xcode workspace/project sits")]
• src/mcpxcodebuild/server.py:69-82 (registration)

  Registers the 'build' tool (and 'test' tool) with the MCP server, providing name, description, and input schema.
  @server.list_tools() async def list_tools() -> list[Tool]: return [ Tool( name = "build", description = "Build the iOS Xcode workspace/project in the folder", inputSchema = Folder.model_json_schema(), ), Tool( name="test", description="Run test for the iOS Xcode workspace/project in the folder", inputSchema=Folder.model_json_schema(), ) ]
• src/mcpxcodebuild/server.py:19-25 (helper)

  Helper function to find the nearest Xcode workspace (.xcworkspace) or project (.xcodeproj) directory by walking the current directory tree.
  def find_xcode_project(): for root, dirs, files in os.walk("."): dirs.sort(reverse = True) for dir in dirs: if dir.endswith(".xcworkspace") or dir.endswith(".xcodeproj"): return os.path.join(root, dir) return None
• src/mcpxcodebuild/server.py:27-52 (helper)

  Helper function to find the first available scheme for the Xcode project/workspace by running 'xcodebuild -list'.
  def find_scheme(project_type: str, project_name: str) -> str: schemes_result = subprocess.run(["xcodebuild", "-list", project_type, project_name], stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False).stdout.decode("utf-8") schemes_lines = schemes_result.splitlines() schemes = [] in_schemes_section = False for line in schemes_lines: if "Schemes:" in line: in_schemes_section = True continue if in_schemes_section: scheme = line.strip() if scheme: schemes.append(scheme) if schemes: return schemes[0] else: return ""