AI导哈

Xcode MCP服务器扩展

一个为Xcode开发提供Model Context Protocol（MCP）服务器功能的Zed扩展，支持xcode-mcp和xcodebuildmcp两种服务器，用于深度集成Xcode开发环境和提供构建测试能力。

  • by tommyming
  • Rust
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tommyming/zed-xcode-mcp-bundle

使用说明

Xcode MCP捆绑包

Zed扩展，为Xcode开发捆绑了两个MCP（模型上下文协议）服务器：

[！注意] Xcode MCP Sever仅在macOS 26上可用。 Xcode 26.3现已发布。安装Xcode 26.3+并确保通过以下方式选择它 xcode-select 在启用MCP服务器之前。 在通过此扩展使用之前，请确保Xcode已打开并且MCP Server可用。

  • Xcode mcp：Xcode 26.3+MCP工具通过 xcrun mcpbridge
  • xcodebuildmcp：XcodeBuildMCP通过 npx -y xcodebuildmcp@latest mcp

此扩展执行 自动飞行前检查 在启动每个上下文服务器之前，确保满足所有先决条件，如果缺少依赖关系，则提供清晰的错误消息。

安装

从Zed市场安装此扩展，或将其添加到Zed配置中。

所得

Xcode mcp

使用Xcode 26.3或更高版本时，显示Xcode的内置MCP工具。此服务器提供与Xcode开发环境的深度集成。

xcodebuildmcp

通过npm提供XcodeBuildMCP功能，为Xcode项目提供构建和测试功能。

设置

Xcode mcp设置

要使用 xcode-mcp 服务器：

  1. 安装Xcode 26.3或更高版本
  2. 确保通过以下方式选择了正确的Xcode xcode-select:
    xcode-select -p
# Should point to /Applications/Xcode.app or your chosen Xcode installation
# If needed, set it with: sudo xcode-select -s /Applications/Xcode.app
  3. 使用您的工作区或项目打开Xcode
  4. 在Xcode中，转到 设置→ 智能→ 模型上下文协议
  5. 启用“Xcode工具”
  6. 在Zed中，打开代理面板→ 上下文服务器
  7. 启用 xcode-mcp 服务器

xcodebuildmcp设置

要使用 xcodebuildmcp 服务器：

  1. 从以下位置安装Node.js nodejs.org
  2. 验证 npx 可用：
    npx --version
  3. 在Zed中，打开代理面板→ 上下文服务器
  4. 启用 xcodebuildmcp 服务器

错误消息和故障排除

此扩展在启动每个上下文服务器之前执行自动飞行前检查。如果缺少先决条件，您将立即收到一条明确的错误消息。以下是如何解决常见问题：

xcode mcp错误

错误：“Xcode 26.3+是必需的： mcpbridge 未找到“

原因：此错误发生在分机的自动飞行前检查期间。您使用的是旧版本的Xcode，或者Xcode安装不正确，或者选择了错误的Xcode安装。

解决方案:

  1. 验证Xcode 26.3+是否已安装：

    xcrun --version

    这应该显示26.3或更高版本。

  2. 验证 mcpbridge 可用：

    xcrun --find mcpbridge

    这应该返回一条路径（例如。， /Applications/Xcode.app/Contents/Developer/usr/bin/mcpbridge).

  3. 检查选择了哪个Xcode：

    xcode-select -p

  4. 如果选择了错误的Xcode，请修复它：

    sudo xcode-select -s /Applications/Xcode.app

  5. 在启用服务器之前，确保Xcode在项目/工作区打开的情况下运行。

  6. 验证Xcode设置中是否启用了Xcode Tools MCP：

    • 打开Xcode→ 设置→ 智能→ 模型上下文协议
    • 确保已选中“Xcode工具”

错误：“启动xcode mcp服务器失败”

可能的原因:

  • Xcode未运行
  • Xcode设置中未启用Xcode工具MCP
  • Zed和Xcode之间的网络或IPC问题

解决方案:

  1. 确保Xcode已打开并加载了项目/工作区
  2. 检查Xcode设置中是否启用了Xcode Tools MCP
  3. 尝试重新启动Xcode，然后在Zed中重新启用服务器
  4. 检查Zed的日志以获取更详细的错误消息

xcodebuildmcp错误

错误：“运行XcodeBuildMCP需要Node.js（npx）。请安装Node.js并确保 npx 在PATH中”

原因：此错误发生在分机的自动飞行前检查期间。未安装Node.js，或 npx 在您的PATH中不可用。

解决方案:

  1. 从以下位置安装Node.js nodejs.org （推荐LTS版本）

  2. 验证Node.js安装：

    node --version

  3. 验证 npx 可用：

    npx --version

    这应该打印一个版本号。

  4. 如果 npx 如果找不到，您可能需要重新启动终端或shell，或检查PATH：

    echo $PATH

    确保Node.js bin目录（例如。， /usr/local/bin 或 /opt/homebrew/bin)在你的路径。

  5. 修复PATH后，重新启动Zed并尝试再次启用服务器。

错误：“启动xcodebuildmcp服务器失败”

可能的原因:

  • 网络连接问题（npx需要下载软件包）
  • npm注册表问题
  • 临时下载失败

解决方案:

  1. 测试 npx 手动查看实际错误：

    npx -y xcodebuildmcp@latest mcp

  2. 检查您的互联网连接

  3. 如果你看到npm注册表错误，请尝试清除npm缓存：

    npm cache clean --force

  4. 如果你在公司防火墙或代理后面，你可能需要配置npm来使用你的代理：

    npm config set proxy http://proxy.company.com:port
npm config set https-proxy http://proxy.company.com:port

  5. 检查Zed的日志以获取更详细的错误消息

一般问题

服务器启动失败，没有明确的错误消息

解决方案:

  1. 打开Zed的日志查看详细的错误消息：

    • 按 Cmd+Shift+P （macOS）或 Ctrl+Shift+P （Linux/Windows）
    • 类型“zed：打开日志”
    • 查找与上下文服务器相关的错误

  2. 尝试在终端中手动运行该命令，查看发生了什么错误：

    # For xcode-mcp
xcrun mcpbridge

# For xcodebuildmcp
npx -y xcodebuildmcp@latest mcp

  3. 如果你发现一个bug或有一个这里没有涵盖的问题，请在GitHub上报告： https://github.com/tommyming/zed-xcode-mcp-bundle/issues

工具重叠行为

这两台服务器可能都具有类似的构建和测试功能。为了获得最佳效果，您可以：

  • 仅启用当前任务所需的服务器
  • 针对不同的工作流使用不同的Zed Agent配置文件

建议的代理商简介

您可以在Zed的设置中创建代理配置文件，以在服务器配置之间快速切换：

配置文件a：“Xcode MCP” （启用 xcode-mcp 仅）

  • 直接在Xcode中工作时，最适合深度Xcode集成
  • 提供对Xcode内部工具和分析的访问

简介B：“XcodeBuildMCP” （启用 xcodebuildmcp 仅）

  • 最适合命令行构建和测试工作流
  • 适用于CI/CD脚本和自动化

配置文件C：“iOS全栈” （启用两者）

  • 当您希望获得最大的工具覆盖率时，效果最佳
  • 将Xcode的深度集成与灵活的构建工具相结合

需求

对于xcode mcp

  • macOS
  • 已安装Xcode 26.3或更高版本
  • 通过以下方式选择Xcode xcode-select
  • Xcode在工作区或项目打开的情况下运行
  • Xcode设置中启用了Xcode工具MCP

对于xcodebuildmcp

  • 已安装Node.js
  • npx 在PATH中可用
  • 互联网连接（通过npx下载）

发展

飞行前检查

该扩展实现了在启动每个上下文服务器之前运行的自动飞行前检查：

  • Xcode mcp：跑步 xcrun --find mcpbridge 验证Xcode 26.3+是否已安装并可访问
  • xcodebuildmcp：跑步 npx --version 验证Node.js和npx是否可用

如果缺少先决条件，这些检查会提供即时反馈，从而避免调试运行时错误。

构建扩展

cargo build --release

这将创建Zed可以加载的WebAssembly文件。

本地测试

  1. 在Zed，按 Cmd+Shift+P （macOS）或 Ctrl+Shift+P （Linux/Windows）
  2. 键入“zed:安装开发扩展”
  3. 导航到此存储库的目录
  4. 选择 extension.toml 文件

扩展将被加载，您可以测试上下文服务器。

查看日志

要查看调试的详细日志，请执行以下操作：

  1. 按 Cmd+Shift+P （macOS）或 Ctrl+Shift+P （Linux/Windows）
  2. 类型“zed：打开日志”

查找前缀为的消息 xcode-mcp-bundle 查看特定于扩展的日志。

许可证

阿帕奇-2.0

仓库

https://github.com/tommyming/zed-xcode-mcp-bundle

贡献

欢迎投稿！请随时提交pull请求或打开bug和功能请求的问题。

相关 MCP