Xcode MCP

🚀 Xcode MCP (模型上下文协议) 服务器

Xcode MCP (模型上下文协议) 服务器是一个全面的 MCP 服务器，它提供了对 Xcode 功能的编程式访问，使 Claude 等 AI 助手能够直接创建、构建、测试和管理 iOS/macOS 项目。

🚀 快速开始

Xcode MCP 服务器为 AI 助手提供了对 Xcode 功能的编程式访问，让其可以直接操作 iOS/macOS 项目。下面将详细介绍其特性、安装、配置和使用方法。

✨ 主要特性

项目管理

• 创建新的 Xcode 项目 - 使用 SwiftUI 模板生成完整的项目结构。
• 构建项目 - 使用可定制的配置编译应用程序。
• 运行测试 - 执行单元测试和 UI 测试。
• 归档应用程序 - 创建用于分发的归档文件。
• 管理方案 - 列出并处理项目方案。

文件操作

• 创建 Swift 文件 - 直接将源代码写入文件系统。
• 修改 Info.plist - 以编程方式更新应用程序配置。
• 创建目录 - 设置项目文件夹结构。
• 读取文件 - 访问和分析现有代码。

模拟器管理

• 列出模拟器 - 查看所有可用的 iOS、watchOS 和 tvOS 模拟器。
• 启动/关闭模拟器 - 控制模拟器的生命周期。
• 安装应用程序 - 将应用程序部署到模拟器。
• 启动应用程序 - 使用特定的捆绑 ID 运行应用程序。
• 捕获屏幕截图 - 以编程方式截取模拟器屏幕截图。

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/xcode-mcp.git
cd xcode-mcp

# 安装依赖
npm install

# 构建项目
npm run build

🔧 详细文档

配置

将以下内容添加到你的 Claude Desktop 配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json) 中：

{
  "mcpServers": {
    "xcode-mcp": {
      "command": "node",
      "args": ["/path/to/xcode-mcp/dist/index.js"],
      "env": {}
    }
  }
}

可用工具

开发

前提条件

• Node.js 16 及以上版本
• Xcode 14 及以上版本
• macOS 12 及以上版本

从源代码构建

npm install
npm run build

在开发环境中运行

npm run dev

贡献

我们欢迎贡献！请参阅我们的 贡献指南 了解详细信息。

要求

• macOS：Xcode 集成必需。
• Xcode：必须安装命令行工具。
• Node.js：版本 16 或更高。

故障排除

常见问题

模拟器未显示：

• 确保 Xcode 已正确安装。
• 运行 xcode-select --install 安装命令行工具。

构建失败：

• 检查 Xcode 项目路径是否正确。
• 验证方案名称是否完全匹配。

MCP 连接错误：

• 配置更改后重启 Claude Desktop。
• 检查日志文件 ~/Library/Logs/Claude/mcp-server-xcode-mcp.log。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

• 基于 Anthropic 的 模型上下文协议 构建。
• 使用 Apple 的 Xcode 命令行工具。

📞 支持

• 问题反馈：GitHub 问题
• 讨论交流：GitHub 讨论
• 文档维基：文档维基

💻 使用示例

基础用法

配置完成后，Claude 可以直接使用这些工具。以下是一些使用示例：

创建新项目

用户："创建一个名为 MyApp 的新 iOS 应用程序"
Claude：*使用 xcode_create_project 生成项目结构*

构建项目

用户："构建我的 iOS 应用程序"
Claude：*使用 xcode_build_project 并传入适当的参数*

管理模拟器

用户："显示可用的模拟器"
Claude：*使用 xcode_list_simulators 显示选项*