Xcode 诊断 MCP 插件

用于从 Xcode 构建日志中提取和查看错误和警告的 MCP（模型控制协议）插件。

概述

此插件实现了模型控制协议 (MCP) 规范，为任何兼容的 AI 助手提供 Xcode 诊断功能。它连接到 Xcode 的构建系统，从您的 Swift 项目中提取、解析和显示诊断信息（错误和警告）。它可以帮助 AI 助手快速识别代码中的问题，而无需手动搜索构建日志。

请注意，由于这在日志级别起作用，因此在运行此工具之前 Xcode 必须已经尝试过构建。

先决条件

macOS 操作系统
已安装 Xcode
Python 3.6+

安装

从 PyPI 安装

安装 Xcode Diagnostics MCP 插件的最简单方法：

pip install mcp-xcode-diagnostics

从 GitHub 安装

您可以直接从 GitHub 安装：

pip install git+https://github.com/leftspin/mcp-xcode-diagnostics.git

从源代码安装

从源安装：

克隆或下载此存储库
使用 pip 安装插件：
cd mcp-xcode-diagnostics pip install .

该插件现在可以与任何兼容 MCP 的客户端一起使用。

特征

列出 DerivedData 中具有构建日志的所有 Xcode 项目
从特定项目的最新构建日志中提取错误和警告
解析复杂的诊断，包括相关注释和修复建议
提供有关每个问题的详细信息，包括文件路径、行号和错误消息
针对捕获 Swift 并发相关警告进行了优化

支持的诊断类型

该插件可以检测并显示各种类型的 Xcode 诊断，包括：

错误

语法错误（例如，“预期‘{’”或“预期表达式”）
类型错误（例如，“无法将类型 X 的值转换为预期参数类型 Y”）
未解析的标识符和缺失的导入
协议一致性错误
通用参数推断失败
访问控制违规

警告

未使用的变量、常量和结果
隐式转换可能会丢失精度
冗余代码或不必要的表达式
弃用警告
字符串插值问题
Swift 并发警告，包括：
- 非隔离全局共享可变状态警告
- 主要演员隔离警告
- 协议一致性并发警告
- Actor 隔离违规
- Swift 6 语言模式兼容性警告

注释和修复建议

相关注释为错误和警告提供了额外的上下文
提出代码更改以解决问题的修复建议
显示有问题的代码片段

限制

运行时日志中的二进制/序列化格式可能无法完全解析
一些高度专业化的诊断格式可能无法识别
非常大的构建日志可能会被截断
项目特定的自定义诊断可能未正确分类

MCP 工具

该插件提供了两个主要的 MCP 工具：

获取xcode项目

列出 DerivedData 目录中所有带有构建日志的 Xcode 项目。

参数：无

获取项目诊断

从特定项目的最新构建日志中获取诊断信息。

参数：

project_dir_name ：DerivedData 中项目的目录名称（例如，'ProjectName-hash'）
include_warnings ：除了错误之外是否包含警告（默认值：True）

调试信息

为了调试目的，插件将原始日志输出保存到：

/tmp/xcode-mcp-debug.log - 主应用程序日志
/tmp/xcode-diagnostic-raw.log - Xcode 活动日志的原始输出

示例输出

{
  "success": true,
  "log_file": "/path/to/build.xcactivitylog",
  "timestamp": "2025-03-11T12:34:56.789",
  "errors": [
    {
      "type": "error",
      "message": "use of unresolved identifier 'NonExistentType'",
      "file_path": "/path/to/MyFile.swift",
      "line_number": 42,
      "column": 15,
      "code": "    let x: NonExistentType = value",
      "notes": []
    }
  ],
  "warnings": [
    {
      "type": "warning",
      "message": "static property 'sharedInstance' is not concurrency-safe because it is nonisolated global shared mutable state; this is an error in the Swift 6 language mode",
      "file_path": "/path/to/SharedManager.swift",
      "line_number": 10,
      "column": 16,
      "code": "    static var sharedInstance: SharedManager?",
      "notes": [
        {
          "type": "note",
          "message": "convert 'sharedInstance' to a 'let' constant to make 'Sendable' shared state immutable",
          "file_path": "/path/to/SharedManager.swift",
          "line_number": 10,
          "column": 16
        }
      ]
    }
  ],
  "error_count": 1,
  "warning_count": 1
}

测试

该插件包括一个测试套件来验证解析功能：

# Run all tests
python -m unittest test_xcode_diagnostics.py

执照

该项目可在 MIT 许可下使用。

Xcode Diagnostics MCP Plugin

Integrations