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?

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

Credentials and setup notes

  • macOS operating system - Xcode installed - Python 3.6+

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
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.