Xcode Diagnostics MCP Server

Extracts and analyzes errors and warnings from Xcode build logs for integration with AI assistants.

Local serverstdioPython 6

What is the Xcode Diagnostics MCP server?

If you already use Xcode Diagnostics, the xcode diagnostics mcp server is the piece that lets your assistant work with it directly. Extracts and analyzes errors and warnings from Xcode build logs for integration with AI assistants.

What the server does

An MCP (Model Control Protocol) plugin for extracting and viewing errors and warnings from Xcode build logs.

This plugin implements the Model Control Protocol (MCP) specification to provide Xcode diagnostics functionality to any compatible AI assistants. It connects to Xcode's build system to extract, parse, and display diagnostics (errors and warnings) from your Swift projects. It helps AI assistants quickly identify issues in your code without having to manually search through build logs.

  • Lists all Xcode projects that have build logs in DerivedData
  • Extracts errors and warnings from the latest build log of a specific project
  • Parses complex diagnostics, including associated notes and fix-it suggestions
  • Provides detailed information about each issue, including file paths, line numbers, and error messages
  • Optimized for capturing Swift concurrency-related warnings

Installation

mcp-xcode-diagnostics on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Errors — The Errors tool exposed by this server
  • Warnings — The Warnings tool exposed by this server
  • get_xcode_projects — Lists all Xcode projects with build logs in the DerivedData directory
  • get_project_diagnostics — Gets diagnostic information from the latest build log of a specific project

Credentials and setup notes

  • macOS operating system - Xcode installed - Python 3.6+

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of monitoring and observability servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Xcode Diagnostics's toolset — Errors, Warnings, get_xcode_projects and 1 more — is a fair guide to whether it matches your workflow. It is maintained by leftspin; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
ErrorsThe Errors tool exposed by this server.
WarningsThe Warnings tool exposed by this server.
get_xcode_projectsLists all Xcode projects with build logs in the DerivedData directory.
get_project_diagnosticsGets diagnostic information from the latest build log of a specific project.

How to install the Xcode Diagnostics MCP server

{
  "mcpServers": {
    "xcode-diagnostics": {
      "command": "uvx",
      "args": ["mcp-xcode-diagnostics"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • macOS operating system - Xcode installed - Python 3.6+

Example prompts to try

  • Use Xcode Diagnostics to Errors.
  • Use Xcode Diagnostics to Warnings.
  • Use Xcode Diagnostics to get xcode projects.

Frequently asked questions

Xcode Diagnostics is a tool that extracts and analyzes errors and warnings from Xcode build logs, making it easier to debug Swift projects. It's designed for integration with AI assistants to help developers quickly identify and resolve issues.