XcodeMCPSwiftApp--Xcode MCP工具资源管理器
一个连接到Xcode 26.3的MCP(模型上下文协议)桥以发现和执行的macOS应用程序 Xcode公开的原生MCP工具——类似于Cursor或Codex如何连接到Xcode的代理编码 能力。
建筑
┌──────────────┐ App Protocol ┌──────────────┐ MCP JSON-RPC ┌────────────┐ XPC ┌───────┐
│XcodeMCPSwift │ ◄────────────► │ MCPBridgeCLI │ ◄─────────────► │ mcpbridge │ ◄────► │ Xcode │
│ App(SwiftUI)│ stdin/stdout │ (MCP Client) │ stdin/stdout │ (Apple) │ │ (IDE) │
└──────────────┘ └──────────────┘ └────────────┘ └───────┘Xcodemcpswiftapp --macOS SwiftUI应用程序采用可组合架构(TCA)构建。 使用 XcodeMCPBridge Swift包(通过SPM) 这提供了 MCPBridgeFeature 减速器, MCPBridgeClient 依赖和伴侣 mcpbridge-cli 二元的。该应用程序提供了一个UI来连接/断开连接、浏览可用工具、, 填充参数并执行它们。
mcpbridge cli --随附的配套CLI二进制文件 XcodeMCPBridge 包裹。充当MCP客户端, 与苹果公司沟通 xcrun mcpbridge 通过stdio上的JSON-RPC 2.0。
依赖项
此应用程序取决于 XcodeMCPBridge Swift软件包 (在Xcode中打开项目或运行时,通过SPM自动解决 xcodegen generate).
先决条件
- macOS 14.0+
- Xcode 26.3 (在设置中启用MCP→ 智能→ “启用模型上下文协议”)
- 项目必须在Xcode中打开 让桥工作
- Swift 5.9+
- Xcodegen (
brew install xcodegen)
注: Xcode MCP工具必须在 智能 Xcode中的设置,以使应用程序正常工作。
建筑
cd XcodeMCPSwiftApp
# Generate Xcode project (requires xcodegen: brew install xcodegen)
xcodegen generate
# Or build from command line
xcodebuild -project XcodeMCPSwiftApp.xcodeproj -scheme XcodeMCPSwiftApp -destination 'platform=macOS' build要运行应用程序,请打开 XcodeMCPSwiftApp.xcodeproj 在Xcode中,选择 Xcodemcpswiftapp 方案和运行(⌘R)。
用法
- 打开
XcodeMCPSwiftApp.xcodeproj在Xcode中运行 Xcodemcpswiftapp 方案
- 首次启动时,该应用程序会安装
mcpbridge-cli二进制从 XcodeMCPBridge 包裹。这需要管理员权限:
CLI installation requires admin privileges
- 确保Xcode 26.3在项目打开的情况下运行,并且启用了MCP
- 点击 连接 --该应用程序将启动CLI,该CLI连接到Xcode的MCP桥
- Apple将提示您允许CLI访问Xcode——点击 允许:
Apple access request for MCPBridgeCLI
- 切换到 工具 选项卡,查看所有可用的Xcode MCP工具
- 选择一个工具,填写参数,然后单击 执行工具
项目结构
project.yml # XcodeGen spec → XcodeMCPSwiftApp.xcodeproj
XcodeMCPSwiftApp.xcodeproj/ # Generated Xcode project (macOS app)
Sources/
└── XcodeMCPSwiftApp/ # macOS SwiftUI app (TCA)
├── XcodeMCPSwiftApp.swift # @main App entry
├── Features/
│ ├── AppFeature.swift # Root TCA reducer
│ ├── ToolListFeature.swift # Tool discovery & listing
│ └── ToolCallFeature.swift # Tool execution with parameters
├── Views/
│ ├── AppView.swift # Main window, sidebar, settings
│ ├── AboutView.swift # About screen
│ ├── ToolListView.swift # Tool list with search
│ └── ToolCallView.swift # Dynamic parameter form + results
└── Services/
└── BridgeClient.swift # TCA dependency (Process management)环境变量
CLI尊重这些环境变量(可以在连接前设置):
MCP_XCODE_PID--当多个Xcode实例运行时,以特定Xcode实例为目标MCP_XCODE_SESSION_ID--标识工具会话的可选UUID
可用的Xcode MCP工具
Xcode 26.3附带了约20个原生MCP工具,包括:
- 建筑项目 --构建Xcode项目
- 运行所有测试 / RunSome测试 --运行测试套件
- 文档搜索 --搜索Apple开发者文档
- 渲染审查 --渲染SwiftUI预览
- 获取项目结构 --探索项目文件层次结构
- GetSchemes --列出可用的构建方案
- 更多(文件管理、代码片段等)
______________________________________________________________________
*“由开发人员为开发人员构建,因为最好的工具是你自己想使用的工具。”* ❤️ — 安东·格雷冈 · @渲染位置
许可证
MIT许可证
版权所有©2026 Anton Gregorn。保留所有权利。
特此免费向任何获得副本的人授予许可 本软件和相关文档文件(“软件”),以处理 在软件中不受限制,包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本,并允许软件的接收者 根据以下条件提供:
上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。
软件按“原样”提供,不提供任何形式的明示或明示担保 隐含的,包括但不限于适销性保证, 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任,无论是在合同、侵权或其他诉讼中, 出于或与软件、使用或其他交易有关 软件。
