xcode.yaml

id: xcode
name: Xcode MCP Server
description: >
  Official Apple Xcode MCP server (xcrun mcpbridge) that gives external AI agents direct
  access to Xcode IDE capabilities. Provides 20 native tools for building projects, running
  tests, reading and writing files in the project navigator, searching code with regex,
  rendering SwiftUI previews, executing code snippets, browsing Apple Developer documentation,
  and inspecting build logs and workspace issues. Requires Xcode 26+ with MCP enabled in
  Intelligence settings.
author:
  name: Apple
  github: apple
repository: https://github.com/apple/swift
transport:
  - stdio
category: Development
tags:
  - xcode
  - apple
  - ios
  - macos
  - swift
  - swiftui
  - testing
  - build
  - preview
  - ide
created_at: "2025-06-09T00:00:00.000Z"
updated_at: "2026-05-27T00:00:00.000Z"
tools:
  - name: BuildProject
    description: >
      Builds an Xcode project using the active scheme and waits until the build completes.
      Returns build result, errors with file paths and line numbers, and full log path.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
      required:
        - tabIdentifier
  - name: GetBuildLog
    description: >
      Gets the log of the current or most recently finished build. Filter by severity
      (error, warning, remark), regex pattern, or file glob.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        severity:
          type: string
          description: Minimum severity to include (error, warning, remark)
        pattern:
          type: string
          description: Regex to filter build log entries
        glob:
          type: string
          description: Glob to filter by file path
      required:
        - tabIdentifier
  - name: RunAllTests
    description: >
      Runs all tests from the active scheme's active test plan and returns results
      with pass/fail counts and error messages.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
      required:
        - tabIdentifier
  - name: RunSomeTests
    description: >
      Runs specific tests by target name and test identifier using the active test plan.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        tests:
          type: array
          description: Array of test specifiers with targetName and testIdentifier
      required:
        - tabIdentifier
        - tests
  - name: GetTestList
    description: >
      Gets all available tests from the active scheme's active test plan with identifiers,
      file paths, and enabled status.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
      required:
        - tabIdentifier
  - name: XcodeRead
    description: >
      Reads file contents within the Xcode project organization with line numbers.
      Supports offset and limit for large files.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        filePath:
          type: string
          description: Path to file in Xcode project organization
        offset:
          type: integer
          description: Line number to start reading from
        limit:
          type: integer
          description: Number of lines to read
      required:
        - tabIdentifier
        - filePath
  - name: XcodeWrite
    description: >
      Creates or overwrites files with content in the Xcode project. Automatically
      adds new files to the project structure.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        filePath:
          type: string
          description: Path to file in Xcode project organization
        content:
          type: string
          description: Content to write to the file
      required:
        - tabIdentifier
        - filePath
        - content
  - name: XcodeUpdate
    description: >
      Edits files by replacing text content (find and replace). Supports replacing
      all occurrences.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        filePath:
          type: string
          description: Path to file in Xcode project organization
        oldString:
          type: string
          description: Text to replace
        newString:
          type: string
          description: Replacement text
      required:
        - tabIdentifier
        - filePath
        - oldString
        - newString
  - name: XcodeLS
    description: >
      Lists files and directories in the Xcode project structure at the specified path.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        path:
          type: string
          description: Project path to browse
        recursive:
          type: boolean
          description: Recursively list all files (truncated to 100 lines)
      required:
        - tabIdentifier
        - path
  - name: XcodeGrep
    description: >
      Searches for text patterns in project files using regex with context lines,
      glob filtering, and multiple output modes.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        pattern:
          type: string
          description: Regex pattern to search for
        path:
          type: string
          description: Directory to search in
        glob:
          type: string
          description: Only search files matching this pattern
      required:
        - tabIdentifier
        - pattern
  - name: XcodeGlob
    description: >
      Finds files in the project structure matching wildcard patterns (e.g. *.swift,
      **/*.json).
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        pattern:
          type: string
          description: File matching pattern using wildcards
      required:
        - tabIdentifier
  - name: RenderPreview
    description: >
      Builds and renders a SwiftUI Preview and returns a snapshot image of the resulting UI.
      Supports preview variant overrides.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        sourceFilePath:
          type: string
          description: Path to the Swift file containing the Preview
        previewDefinitionIndexInFile:
          type: integer
          description: Zero-based index of the Preview macro in the file
      required:
        - tabIdentifier
        - sourceFilePath
  - name: ExecuteSnippet
    description: >
      Builds and runs a Swift code snippet in the context of a specific file. Returns
      console output from print statements.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        codeSnippet:
          type: string
          description: Swift code snippet to execute
        sourceFilePath:
          type: string
          description: Swift file whose context the snippet has access to
        purpose:
          type: string
          description: Short description of the purpose
      required:
        - tabIdentifier
        - codeSnippet
        - sourceFilePath
        - purpose
  - name: DocumentationSearch
    description: >
      Searches Apple Developer Documentation using semantic matching. Optionally
      filter by specific frameworks.
    input_schema:
      type: object
      properties:
        query:
          type: string
          description: The search query
        frameworks:
          type: array
          description: Framework(s) to search in
      required:
        - query
  - name: XcodeRefreshCodeIssuesInFile
    description: >
      Retrieves current compiler diagnostics (errors, warnings, notes) for a specific
      file in the project.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        filePath:
          type: string
          description: Path to file in Xcode project organization
      required:
        - tabIdentifier
        - filePath
  - name: XcodeListNavigatorIssues
    description: >
      Lists all current issues shown in Xcode's Issue Navigator including build errors,
      package resolution problems, and workspace configuration issues.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        severity:
          type: string
          description: Minimum severity (error, warning, remark)
      required:
        - tabIdentifier
  - name: XcodeGetCurrentFile
    description: >
      Gets information about the currently active file in the Xcode editor including
      path, content, and selection.
    input_schema:
      type: object
      properties:
        tabIdentifier:
          type: string
          description: The workspace tab identifier
        includeContent:
          type: boolean
          description: Whether to include file content
        includeSelection:
          type: boolean
          description: Whether to include selection information
      required:
        - tabIdentifier
  - name: XcodeListWindows
    description: >
      Lists the current Xcode windows and their workspace information.
    input_schema:
      type: object
      properties: {}
install:
  command: xcrun
  args:
    - mcpbridge
license: MIT
version: "26.5"
stars: 0