XcodeErrorMCP

一个轻量的 Model Context Protocol（MCP）服务器：运行 xcodebuild，并只返回 build errors（不包含 warnings），方便在 AI/自动化流程里快速定位编译失败原因。

Features（功能）

• 通过 stdio JSON-RPC 提供 MCP 工具：xcode_build_errors、xcode_last_errors。
• 自动从 .xcactivitylog 提取诊断信息；如果找不到日志则回退解析 xcodebuild 输出。
• 支持指定/自动发现 workspace 或 project（当前目录仅有一个时可自动发现）。

Requirements（环境要求）

• macOS 13+
• Xcode（需要 /usr/bin/xcodebuild 可用）
• Swift toolchain（随 Xcode 提供）

Install（NPM 安装）

仅支持 macOS。安装时会通过 swift build -c release 从源码编译二进制（需要已安装 Xcode）。

• 如果该包已发布到 npm：npm i -g xcodeerrormcp
• 如果你看到 E404 Not Found（说明尚未发布到 npm），可以用下面任意一种方式安装：
  • 从源码目录安装：npm i -g /path/to/XcodeErrorMCP
  • 从本地 tarball 安装：npm i -g /path/to/xcodeerrormcp-0.1.0.tgz（可用 npm pack 生成）
  • 从 GitHub 安装：npm i -g git+https://github.com/Johnnydaszhu/XcodeErrorMCP.git
• 验证：xcodeerrormcp（或 xcode-error-mcp；启动 MCP server，等待 stdin 的 JSON-RPC 消息）

Install（Homebrew 安装）

brew install --HEAD --formula https://raw.githubusercontent.com/Johnnydaszhu/XcodeErrorMCP/main/Formula/xcode-error-mcp.rb

MCP Client Config（在客户端里配置）

示例（Claude Desktop / Cursor 等类似配置结构）：

{
  "mcpServers": {
    "xcode-error-mcp": {
      "command": "xcodeerrormcp",
      "args": []
    }
  }
}

Tools（可用工具）

xcode_build_errors

运行 xcodebuild build 并返回错误摘要（无 warning）。常用参数：

• scheme（必填：参数或环境变量 XCODE_SCHEME）
• workspace / project（二选一；不填时会尝试自动发现）
• configuration（默认 Debug）
• destination、sdk、derivedDataPath、resultBundlePath、clonedSourcePackagesDirPath
• extraArgs（xcodebuild 额外参数数组，追加在 build action 前）
• workingDirectory（用于自动发现工程/相对路径）
• codeSigningAllowed（默认 false，会设置 CODE_SIGNING_ALLOWED=NO）

也支持通过环境变量传参（参数优先生效），常用：XCODE_SCHEME、XCODE_WORKSPACE/XCODE_PROJECT、XCODE_DESTINATION、XCODE_DERIVED_DATA_PATH。

xcode_last_errors

从最新的 .xcactivitylog 中提取错误（无 warning）。参数：

• derivedDataPath（可选；未提供时默认使用 ~/Library/Developer/Xcode/DerivedData）
• sinceSeconds（可选；只考虑最近 N 秒内修改的日志）

Security Note（安全提示）

该服务器会执行 xcodebuild，而 xcodebuild 可能触发项目里的脚本/构建步骤。只在你信任的代码仓库上使用。

License

MIT