Xcodemcpwrapper
X

Xcodemcpwrapper

Xcode MCP桥接器包装工具,解决Xcode 26.3的MCP桥接器与Cursor等严格遵循MCP规范的客户端兼容性问题,通过转换响应格式确保工具正常工作
2.5分
3.8K

什么是XcodeMCPWrapper?

XcodeMCPWrapper是一个智能适配器,它修复了Xcode 26.3的MCP桥接工具(mcpbridge)与严格遵循MCP规范的AI开发工具(如Cursor)之间的兼容性问题。Xcode的原始工具返回的响应格式不符合MCP规范,导致某些AI工具无法正常使用Xcode功能。这个包装器自动修正响应格式,让所有AI助手都能无缝使用Xcode的开发工具。

如何使用XcodeMCPWrapper?

使用非常简单:1) 确保已安装Xcode 26.3+并启用MCP功能;2) 选择一种安装方式(推荐使用uvx);3) 在您的AI开发工具(Cursor、Claude Code等)中配置MCP服务器;4) 重启工具即可开始使用Xcode功能。整个过程只需几分钟。

适用场景

适合所有使用AI助手进行iOS/macOS开发的开发者。特别是:1) 使用Cursor、Claude Code、Codex CLI等AI开发工具的用户;2) 需要AI助手帮助构建、测试、调试Xcode项目的开发者;3) 希望提高Xcode开发效率的团队;4) 遇到Xcode MCP工具在AI助手中无法正常工作的用户。

主要功能

MCP规范兼容性修复
自动修正Xcode mcpbridge返回的响应格式,确保符合MCP规范,解决Cursor等严格客户端无法使用Xcode工具的问题。
代理模式(Broker Mode)
支持代理模式,允许多个短命的MCP客户端会话共享一个持久的上游桥接会话,减少Xcode的连接确认弹窗。
Web UI监控面板
可选的可视化监控面板,提供实时指标、工具使用分析、审计日志和请求检查器,帮助监控MCP工具调用。
多客户端支持
全面支持Cursor、Claude Code、Codex CLI、Zed Agent、Kimi CLI等多种AI开发工具,配置简单。
终端监控界面(TUI)
提供终端用户界面,可在命令行中实时监控MCP工具调用和系统状态。
简易安装
提供多种安装方式:uvx一键安装、pip安装、手动安装脚本,满足不同用户需求。
优势
解决兼容性问题:修复Xcode与严格MCP客户端之间的兼容性,让所有AI工具都能使用Xcode功能
性能优异:转换开销极低(<0.01ms),内存占用小(<10MB),几乎不影响性能
配置灵活:支持多种安装和配置方式,适应不同用户的工作流程
监控完善:提供Web UI和TUI两种监控方式,帮助用户了解工具使用情况
社区活跃:开源项目,持续更新,有详细的文档和故障排除指南
局限性
依赖特定版本:需要Xcode 26.3+,旧版本Xcode不支持
macOS专属:仅适用于macOS系统,无法在Windows或Linux上使用
需要手动启用:必须在Xcode设置中手动启用MCP功能
初始配置:首次使用需要一些配置步骤,对新用户可能有些复杂
代理模式限制:代理模式下首次连接可能遇到Xcode权限弹窗时机问题

如何使用

启用Xcode MCP功能
打开Xcode → 设置(⌘,) → 选择Intelligence → 在Model Context Protocol下启用Xcode Tools。这是必须的步骤,否则工具无法工作。
选择安装方式
推荐使用uvx一键安装:无需手动安装,uvx会自动下载和运行。也可以选择pip安装或手动安装。
配置AI开发工具
根据您使用的AI工具,编辑相应的配置文件。以下是Cursor的配置示例(推荐使用代理模式)。
重启并验证
重启您的AI开发工具,验证Xcode工具是否可用。可以询问AI助手关于Xcode项目的问题来测试。

使用案例

项目构建与运行
当您需要AI助手帮助构建和运行Xcode项目时,可以直接让AI执行构建命令,无需手动操作Xcode。
测试执行
需要运行项目测试时,可以让AI助手执行测试套件,并汇总测试结果。
代码搜索与分析
在大型项目中查找特定文件或代码模式时,AI助手可以快速搜索并返回结果。
错误诊断
当项目构建失败时,AI助手可以分析构建日志,帮助诊断问题。

常见问题

为什么我的AI工具显示找到了0个Xcode工具?
代理模式和直接模式有什么区别?
Web UI面板无法访问怎么办?
支持哪些AI开发工具?
安装后需要重启电脑吗?
这个工具安全吗?会不会泄露我的代码?

相关资源

GitHub仓库
项目源代码、问题追踪和最新版本
MCP协议规范
Model Context Protocol官方规范文档
Xcode 26.4发布说明
Apple官方Xcode发布说明,包含MCP相关更新
代理模式详细指南
代理模式的详细配置、迁移和操作指南
Web UI设置指南
Web UI监控面板的详细配置和使用说明
故障排除指南
常见问题解决方案和诊断步骤

安装

复制以下命令到你的Client进行配置
{
  "mcpServers": {
    "xcode-tools": {
      "command": "uvx",
      "args": ["--from", "mcpbridge-wrapper", "mcpbridge-wrapper", "--broker"]
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpbridge-wrapper[webui]",
        "mcpbridge-wrapper",
        "--broker",
        "--web-ui",
        "--web-ui-config",
        "/Users/YOUR_USERNAME/.mcpbridge_wrapper/webui.json"
      ]
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "uvx",
      "args": ["--from", "mcpbridge-wrapper", "mcpbridge-wrapper"]
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpbridge-wrapper[webui]",
        "mcpbridge-wrapper",
        "--web-ui",
        "--web-ui-port",
        "8080"
      ]
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "/Users/YOUR_USERNAME/bin/xcodemcpwrapper",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "/Users/YOUR_USERNAME/bin/xcodemcpwrapper",
      "args": ["--web-ui", "--web-ui-port", "8080"]
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "/path/to/XcodeMCPWrapper/.venv/bin/mcpbridge-wrapper"
    }
  }
}

{
  "mcpServers": {
    "xcode-tools": {
      "command": "/path/to/XcodeMCPWrapper/.venv/bin/mcpbridge-wrapper",
      "args": ["--web-ui", "--web-ui-port", "8080"]
    }
  }
}
注意:您的密钥属于敏感信息,请勿与任何人分享。

替代品

V
Vestige
Vestige是一个基于认知科学的AI记忆引擎,通过实现预测误差门控、FSRS-6间隔重复、记忆梦境等29个神经科学模块,为AI提供长期记忆能力。包含3D可视化仪表板和21个MCP工具,完全本地运行,无需云端。
Rust
4.5K
4.5分
M
Moltbrain
MoltBrain是一个为OpenClaw、MoltBook和Claude Code设计的长期记忆层插件,能够自动学习和回忆项目上下文,提供智能搜索、观察记录、分析统计和持久化存储功能。
TypeScript
4.1K
4.5分
B
Bm.md
一个功能丰富的Markdown排版工具,支持多种样式主题和平台适配,提供实时编辑预览、图片导出和API集成能力
TypeScript
4.4K
5分
S
Security Detections MCP
Security Detections MCP 是一个基于Model Context Protocol的服务器,允许LLM查询统一的安全检测规则数据库,涵盖Sigma、Splunk ESCU、Elastic和KQL格式。最新3.0版本升级为自主检测工程平台,可自动从威胁情报中提取TTPs、分析覆盖差距、生成SIEM原生格式检测规则、运行测试并验证。项目包含71+工具、11个预构建工作流提示和知识图谱系统,支持多SIEM平台。
TypeScript
6.0K
4分
P
Paperbanana
PaperBanana是一个自动化生成学术图表和统计图的智能框架,支持从文本描述生成高质量的论文插图,采用多智能体管道和迭代优化,提供CLI、Python API和MCP服务器等多种使用方式。
Python
7.7K
5分
B
Better Icons
一个提供超过20万图标搜索和检索的MCP服务器和CLI工具,支持150多个图标库,帮助AI助手和开发者快速获取和使用图标。
TypeScript
6.7K
4.5分
A
Assistant Ui
assistant-ui是一个开源TypeScript/React库,用于快速构建生产级AI聊天界面,提供可组合的UI组件、流式响应、无障碍访问等功能,支持多种AI后端和模型。
TypeScript
7.3K
5分
A
Apify MCP Server
Apify MCP服务器是一个基于模型上下文协议(MCP)的工具,允许AI助手通过数千个现成的爬虫、抓取器和自动化工具(Apify Actor)从社交媒体、搜索引擎、电商等网站提取数据。它支持OAuth和Skyfire代理支付,可通过HTTPS端点或本地stdio方式集成到Claude、VS Code等MCP客户端中。
TypeScript
7.5K
5分
D
Duckduckgo MCP Server
已认证
DuckDuckGo搜索MCP服务器,为Claude等LLM提供网页搜索和内容抓取服务
Python
85.7K
4.3分
F
Firecrawl MCP Server
Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器,提供丰富的网页抓取、搜索和内容提取功能。
TypeScript
149.8K
5分
F
Figma Context MCP
Framelink Figma MCP Server是一个为AI编程工具(如Cursor)提供Figma设计数据访问的服务器,通过简化Figma API响应,帮助AI更准确地实现设计到代码的一键转换。
TypeScript
75.8K
4.5分
B
Baidu Map
已认证
百度地图MCP Server是国内首个兼容MCP协议的地图服务,提供地理编码、路线规划等10个标准化API接口,支持Python和Typescript快速接入,赋能智能体实现地图相关功能。
Python
50.1K
4.5分
E
Exa Web Search
已认证
Exa MCP Server是一个为AI助手(如Claude)提供网络搜索功能的服务器,通过Exa AI搜索API实现实时、安全的网络信息获取。
TypeScript
57.3K
5分
C
Context7
Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务,通过Model Context Protocol直接集成到提示中,解决LLM使用过时信息的问题。
TypeScript
106.0K
4.7分
M
Minimax MCP Server
MiniMax Model Context Protocol (MCP) 是一个官方服务器,支持与强大的文本转语音、视频/图像生成API交互,适用于多种客户端工具如Claude Desktop、Cursor等。
Python
63.6K
4.8分
E
Edgeone Pages MCP Server
EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务
TypeScript
32.0K
4.8分
AIBase
智启未来,您的人工智能解决方案智库