Xcode Errors

You set up an MCP server that exposes Xcode build diagnostics and console output to Cursor, letting you monitor errors, warnings, and logs in real time and apply fixes automatically within your workflow.

How to use

You interact with the Xcode Errors MCP Server through your MCP client inside Cursor. Once the server is running, you can query for the current build errors, monitor live console output, and analyze your Swift/SwiftUI project structure. You can also read and write project files as part of diagnostics-driven workflows.

How to install

Prerequisites you need before starting: Python 3.x and a working Python virtual environment. You also need a Cursor client configured for MCP access.

# Step 1: Install dependencies and prepare the environment
./install.sh

# Step 2: Run a quick parser test (optional but recommended)
python3 examples/test_parser.py

# Step 3: Prepare Cursor MCP configuration (example paths shown; replace with your actual paths)
# See the configuration snippet in the provider configuration below

Configuration and usage notes

The MCP server is intended to run as a local stdio process that Cursor can launch. Use the provided example to point Cursor at the server script and to set the Python path correctly so all modules load as expected.

Summary of the required configuration snippet to place in Cursor MCP settings (replace your actual installation path accordingly):

{
  "mcpServers": {
    "xcode_errors": {
      "command": "venv/bin/python",
      "args": [
        "/Users/yourname/xcode-errors-mcp/src/xcode_mcp_server.py"
      ],
      "env": {
        "PYTHONPATH": "/Users/yourname/xcode-errors-mcp/src"
      }
    }
  }
}

Additional setup and testing steps

After configuring Cursor, restart Cursor completely to activate the MCP server connection. You should see a green indicator in Cursor settings indicating the MCP server is ready. If the indicator turns red, verify the path to the server script and the PYTHONPATH setting.

Project usage patterns

Build a project in Xcode to generate logs. In Cursor, you can then use the following capabilities to work with diagnostics: get_build_errors() to retrieve current build errors, get_console_logs() to stream debug output, list_recent_projects() to enumerate projects, and analyze_project("ProjectName") to analyze issues within a specific project.

Available tools

get_build_errors

Fetches current Xcode build errors detected in the most recent build pass.

get_console_logs

Streams real-time Xcode console output and debug logs.

analyze_project

Analyzes the Swift/SwiftUI project for common issues and potential fixes.

read_file

Reads a file from the project workspace for inspection or modification.

write_file

Writes changes back to a project file based on diagnostics and automated suggestions.