Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (xcodeerrormcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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