Xcode Diagnostics MCP Plugin
2025.03.25
3
PythonXcode 诊断构建日志分析Swift 并发警告开发效率
mcp-xcode-diagnostics 是一个基于 Model Control Protocol (MCP) 的插件，主要用于从 Xcode 构建日志中提取和查看错误和警告。它帮助 AI 助手快速识别代码中的问题，而无需手动搜索构建日志。该插件支持多种诊断类型，包括语法错误、类型错误、未使用的变量、隐式转换警告等，特别优化了 Swift 并发相关警告的捕获。
View on GitHub
Overview
基本能力
产品定位
mcp-xcode-diagnostics 是一个专为 Xcode 开发者设计的工具，用于自动化提取和分析构建日志中的错误和警告，提高开发效率。
核心功能
- 列出所有在 DerivedData 中有构建日志的 Xcode 项目
- 从特定项目的最新构建日志中提取错误和警告
- 解析复杂的诊断信息，包括相关注释和修复建议
- 提供每个问题的详细信息，包括文件路径、行号和错误消息
- 特别优化了 Swift 并发相关警告的捕获
适用场景
- 开发者在 Xcode 中构建项目后，快速查看构建错误和警告
- AI 助手需要自动化分析代码问题
- 团队协作中，快速共享和定位构建问题
工具列表
- get_xcode_projects: 列出所有在 DerivedData 中有构建日志的 Xcode 项目。
-
参数：无
-
get_project_diagnostics: 从特定项目的最新构建日志中获取诊断信息。
- 参数：
project_dir_name: DerivedData 中的项目目录名称（例如 'ProjectName-hash'）include_warnings: 是否包括警告（默认：True）
常见问题解答
-
Q: 该插件支持哪些诊断类型？ A: 支持语法错误、类型错误、未使用的变量、隐式转换警告等，特别优化了 Swift 并发相关警告。
-
Q: 该插件有哪些限制？ A: 二进制/序列化格式的运行时日志可能无法完全解析；某些高度专业化的诊断格式可能无法识别；非常大的构建日志可能会被截断。
使用教程
使用依赖
- macOS 操作系统
- 已安装 Xcode
- Python 3.6+
安装教程
从 PyPI 安装
pip install mcp-xcode-diagnostics
从 GitHub 安装
pip install git+https://github.com/leftspin/mcp-xcode-diagnostics.git
从源码安装
- 克隆或下载仓库
- 使用 pip 安装插件：
bash cd mcp-xcode-diagnostics pip install .
调试方式
插件将原始日志输出保存到以下位置：
- /tmp/xcode-mcp-debug.log - 主应用程序日志
- /tmp/xcode-diagnostic-raw.log - Xcode 活动日志的原始输出
运行测试套件：
python -m unittest test_xcode_diagnostics.py