Xcode Monitor MCP Server

Name: Xcode Monitor MCP Server
Author: wblair8689

@wblair8689

リポジトリ

Xcode Monitor MCP Server について

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

#xcode #monitoring #swift

基本情報

カテゴリ

その他

ランタイム

python

トランスポート

stdio

公開者

wblair8689

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.