AI导哈

Xcode MCP工具浏览器

一款macOS应用，连接Xcode 26.3的MCP（模型上下文协议）桥接器，用于发现和执行Xcode提供的原生MCP工具。

  • by renderplace
  • Swift
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 renderplace/XcodeMCPSwiftApp

使用说明

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）。

用法

  1. 打开 XcodeMCPSwiftApp.xcodeproj 在Xcode中运行 Xcodemcpswiftapp 方案

  2. 首次启动时，该应用程序会安装 mcpbridge-cli 二进制从 XcodeMCPBridge 包裹。这需要管理员权限：

  3. 确保Xcode 26.3在项目打开的情况下运行，并且启用了MCP

  4. 点击 连接 --该应用程序将启动CLI，该CLI连接到Xcode的MCP桥

  5. Apple将提示您允许CLI访问Xcode——点击 允许:

  6. 切换到 工具 选项卡，查看所有可用的Xcode MCP工具

  7. 选择一个工具，填写参数，然后单击 执行工具

项目结构

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。保留所有权利。

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

相关 MCP