Xcode Monitor MCP Server
About
Swift MCP server for real-time Xcode project diagnostics and monitoring
Explore
- Real-time Xcode Project Monitoring: Detect workspaces, projects, and schemes
- Live Diagnostics: Get Swift/Xcode build errors and warnings
- SourceKit-LSP Integration: Monitor Language Server Protocol status
- Build Server Support: Configure and monitor Xcode build servers
- File Change Detection: Monitor Swift, Objective-C, and C/C++ file changes
- Multi-Platform Support: Works with Claude Desktop and Windsurf
- Comprehensive Logging: Detailed error reporting and debugging
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Xcode Monitor MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Prerequisites
- macOS (required for Xcode integration)
- Python 3.10+ (tested with Python 3.13)
- Xcode and Xcode Command Line Tools
- Node.js (for some MCP features)
Once connected, the following tools are available to AI assistants:
- get_project_path() - Get the current monitored project path
- set_project_path(new_path) - Change the monitored project path
- get_project_status() - Get comprehensive project information
- get_diagnostics() - Get current Swift/Xcode diagnostics and errors
- get_xcode_live_diagnostics() - Get live diagnostics directly from Xcode
- clear_diagnostics_queue() - Clear the diagnostics queue
- get_build_server_status() - Check build server configuration
- get_recent_updates() - Get recent updates from the monitoring queue
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"xcode monitor mcp server": {
"XcodeMonitorMCP": {
"command": "python3",
"args": [
"XcodeMonitor/working_swift_mcp_server.py",
"--help"
]
}
}
}
}McpServers
{
"XcodeMonitorMCP": {
"command": "python3",
"args": [
"XcodeMonitor/working_swift_mcp_server.py",
"--help"
]
}
}A comprehensive Model Context Protocol (MCP) server for monitoring Swift/Xcode projects, providing real-time diagnostics, build status, and project information to AI assistants like Claude Desktop and Windsurf.
✅ Current Status: WORKING
The MCP server is now fully operational and successfully connects to both Claude Desktop and Windsurf.
Features
- Real-time Xcode Project Monitoring: Detect workspaces, projects, and schemes
- Live Diagnostics: Get Swift/Xcode build errors and warnings
- SourceKit-LSP Integration: Monitor Language Server Protocol status
- Build Server Support: Configure and monitor Xcode build servers
- File Change Detection: Monitor Swift, Objective-C, and C/C++ file changes
- Multi-Platform Support: Works with Claude Desktop and Windsurf
- Comprehensive Logging: Detailed error reporting and debugging
Installation
Prerequisites
- macOS (required for Xcode integration)
- Python 3.10+ (tested with Python 3.13)
- Xcode and Xcode Command Line Tools
- Node.js (for some MCP features)
1. Install Dependencies
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
