Xcode Monitor MCP Server

@wblair8689

About Xcode Monitor MCP Server

Swift MCP server for real-time Xcode project diagnostics and monitoring

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "XcodeMonitorMCP": {
      "command": "python3",
      "args": [
        "XcodeMonitor/working_swift_mcp_server.py",
        "--help"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Xcode Monitor MCP Server?

A comprehensive Model Context Protocol (MCP) server for monitoring Swift/Xcode projects. It provides real‑time diagnostics, build status, and project information to AI assistants such as Claude Desktop and Windsurf. Intended for developers working with Xcode projects who want AI‑assisted monitoring and debugging.

How to use Xcode Monitor MCP Server?

Install the MCP library (pip3 install --break-system-packages mcp), clone the repository, then configure Claude Desktop or Windsurf with the provided JSON configuration. The server is started by running working_swift_mcp_server.py with a --swiftpath argument pointing to the project directory. After connection, AI assistants can call tools like get_project_status(), get_diagnostics(), and get_recent_updates().

Key features of Xcode Monitor MCP Server

Real‑time Xcode project monitoring (workspaces, projects, schemes)
Live Swift/Xcode build errors and warnings
SourceKit‑LSP status monitoring
Build server configuration and monitoring
File change detection for Swift, Objective‑C, and C/C++ files
Multi‑platform support (Claude Desktop and Windsurf)

Use cases of Xcode Monitor MCP Server

Ask an AI assistant “Are there any build errors in my Swift code?”
Get live diagnostics directly from Xcode without opening Xcode itself
Monitor a project for file changes during active development
Check SourceKit‑LSP status and build server configuration
Obtain a quick summary of recent project updates and build status

FAQ from Xcode Monitor MCP Server

What are the prerequisites for running Xcode Monitor MCP Server?

macOS (required for Xcode integration), Python 3.10+ (tested with Python 3.13), Xcode and Xcode Command Line Tools, and Node.js (for some MCP features).

How do I install the server?

Install the MCP library with pip3 install --break-system-packages mcp, clone the repository, then update the MCP server configuration for Claude Desktop (claude_desktop_config.json) or Windsurf (settings.json) with the absolute path to working_swift_mcp_server.py.

How can I check for connection issues?

Restart the application (Claude Desktop or Windsurf), then check log files: tail -f ~/Library/Application\ Support/Claude/logs/mcp-server-xcode_monitor.log. You can also test the server manually with python3 XcodeMonitor/working_swift_mcp_server.py --help.

How do I get help with Windsurf‑specific problems?

If you see “npx not found”, use full paths to executables in the configuration. Restart both applications if they interfere with each other. Detailed guidance is provided in the WINDSURF_TROUBLESHOOTING.md file.

What monitoring capabilities does the server have?

It can report on workspaces and projects (.xcworkspace, .xcodeproj), build status (success/failure), file changes for Swift/Objective‑C/C++ files, and diagnostics from Xcode live logs, XCLogParser, SourceKit‑LSP, and SwiftPM build logs.

Frequently asked questions

What are the prerequisites for running Xcode Monitor MCP Server?

macOS (required for Xcode integration), Python 3.10+ (tested with Python 3.13), Xcode and Xcode Command Line Tools, and Node.js (for some MCP features).

How do I install the server?

Install the MCP library with `pip3 install --break-system-packages mcp`, clone the repository, then update the MCP server configuration for Claude Desktop (`claude_desktop_config.json`) or Windsurf (`settings.json`) with the absolute path to `working_swift_mcp_server.py`.

How can I check for connection issues?

Restart the application (Claude Desktop or Windsurf), then check log files: `tail -f ~/Library/Application\ Support/Claude/logs/mcp-server-xcode_monitor.log`. You can also test the server manually with `python3 XcodeMonitor/working_swift_mcp_server.py --help`.

How do I get help with Windsurf‑specific problems?

If you see “npx not found”, use full paths to executables in the configuration. Restart both applications if they interfere with each other. Detailed guidance is provided in the `WINDSURF_TROUBLESHOOTING.md` file.

What monitoring capabilities does the server have?

It can report on workspaces and projects (`.xcworkspace`, `.xcodeproj`), build status (success/failure), file changes for Swift/Objective‑C/C++ files, and diagnostics from Xcode live logs, XCLogParser, SourceKit‑LSP, and SwiftPM build logs.

Comments

Basic information

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.