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 服务器：
- 安装Xcode 26.3或更高版本
- 确保通过以下方式选择了正确的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- 使用您的工作区或项目打开Xcode
- 在Xcode中，转到 设置→ 智能→ 模型上下文协议
- 启用“Xcode工具”
- 在Zed中，打开代理面板→ 上下文服务器
- 启用
xcode-mcp服务器
xcodebuildmcp设置
要使用 xcodebuildmcp 服务器：
- 从以下位置安装Node.js
- 验证
npx可用：
npx --version- 在Zed中，打开代理面板→ 上下文服务器
- 启用
xcodebuildmcp服务器
错误消息和故障排除
此扩展在启动每个上下文服务器之前执行自动飞行前检查。如果缺少先决条件，您将立即收到一条明确的错误消息。以下是如何解决常见问题：
xcode mcp错误
错误：“Xcode 26.3+是必需的： mcpbridge 未找到“
原因：此错误发生在分机的自动飞行前检查期间。您使用的是旧版本的Xcode，或者Xcode安装不正确，或者选择了错误的Xcode安装。
解决方案:
- 验证Xcode 26.3+是否已安装：
xcrun --version这应该显示26.3或更高版本。
- 验证
mcpbridge可用：
xcrun --find mcpbridge这应该返回一条路径（例如。， /Applications/Xcode.app/Contents/Developer/usr/bin/mcpbridge).
- 检查选择了哪个Xcode：
xcode-select -p- 如果选择了错误的Xcode，请修复它：
sudo xcode-select -s /Applications/Xcode.app- 在启用服务器之前，确保Xcode在项目/工作区打开的情况下运行。
- 验证Xcode设置中是否启用了Xcode Tools MCP：
- 打开Xcode→ 设置→ 智能→ 模型上下文协议 - 确保已选中“Xcode工具”
错误：“启动xcode mcp服务器失败”
可能的原因:
- Xcode未运行
- Xcode设置中未启用Xcode工具MCP
- Zed和Xcode之间的网络或IPC问题
解决方案:
- 确保Xcode已打开并加载了项目/工作区
- 检查Xcode设置中是否启用了Xcode Tools MCP
- 尝试重新启动Xcode，然后在Zed中重新启用服务器
- 检查Zed的日志以获取更详细的错误消息
xcodebuildmcp错误
错误：“运行XcodeBuildMCP需要Node.js（npx）。请安装Node.js并确保 npx 在PATH中”
原因：此错误发生在分机的自动飞行前检查期间。未安装Node.js，或 npx 在您的PATH中不可用。
解决方案:
- 从以下位置安装Node.js （推荐LTS版本）
- 验证Node.js安装：
node --version- 验证
npx可用：
npx --version这应该打印一个版本号。
- 如果
npx如果找不到，您可能需要重新启动终端或shell，或检查PATH：
echo $PATH确保Node.js bin目录（例如。， /usr/local/bin 或 /opt/homebrew/bin)在你的路径。
- 修复PATH后，重新启动Zed并尝试再次启用服务器。
错误：“启动xcodebuildmcp服务器失败”
可能的原因:
- 网络连接问题（npx需要下载软件包）
- npm注册表问题
- 临时下载失败
解决方案:
- 测试
npx手动查看实际错误：
npx -y xcodebuildmcp@latest mcp- 检查您的互联网连接
- 如果你看到npm注册表错误，请尝试清除npm缓存：
npm cache clean --force- 如果你在公司防火墙或代理后面，你可能需要配置npm来使用你的代理：
npm config set proxy http://proxy.company.com:port
npm config set https-proxy http://proxy.company.com:port- 检查Zed的日志以获取更详细的错误消息
一般问题
服务器启动失败，没有明确的错误消息
解决方案:
- 打开Zed的日志查看详细的错误消息：
- 按 Cmd+Shift+P （macOS）或 Ctrl+Shift+P （Linux/Windows） - 类型“zed：打开日志” - 查找与上下文服务器相关的错误
- 尝试在终端中手动运行该命令，查看发生了什么错误：
# For xcode-mcp
xcrun mcpbridge
# For xcodebuildmcp
npx -y xcodebuildmcp@latest mcp- 如果你发现一个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文件。
本地测试
- 在Zed，按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Linux/Windows） - 键入“zed:安装开发扩展”
- 导航到此存储库的目录
- 选择
extension.toml文件
扩展将被加载，您可以测试上下文服务器。
查看日志
要查看调试的详细日志，请执行以下操作：
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Linux/Windows） - 类型“zed：打开日志”
查找前缀为的消息 xcode-mcp-bundle 查看特定于扩展的日志。
许可证
阿帕奇-2.0
仓库
https://github.com/tommyming/zed-xcode-mcp-bundle
贡献
欢迎投稿！请随时提交pull请求或打开bug和功能请求的问题。