mcpbridge-wrapper 외부 MCP 클라이언트를 Apple을 통해 Xcode로 연결 xcrun mcpbridge. Xcode 도구 응답을 수리합니다. outputSchema 하지만 omit structuredContent. 수리는 모두에서 작동 브로커 모드. 브로커 모드는 또한 여러 클라이언트를 공유 한 영구 Xcode 연결, 반복 연결 프롬프트 감소.

호환성

| 구성요소 | 0.5.0 지원 | 인포메이션 | Xcode | 26.3+ 및 27.0 on macOS; Xcode 27.0 핸디크 및 도구 발견 확인 | | MCP 클라이언트 | initialize 라이프사이클을 이용한 클라이언트 | | MCP 2026-07-28 | 0.5.0에 의해 지원되지 않습니다. 세션리스 구현은 별도 지점에서 실험을 합니다 | | Python | 3.9-3.12; uvx는 자체 환경을 관리합니다 |

래퍼는 ** 번들 Xcode 도구가 아닙니다. 그것은에 의해 반환된 카탈로그를 노출 설치된 Xcode, 그래서 도구 이름 및 가용성은 Xcode로 변경할 수 있습니다 업데이트 및 권한. Xcode 27.0 카탈로그는 빌드 27A266a 아래에 나열되어 있습니다.

빠른 시작

1. uv를 설치하고 Xcode 26.3 또는 더 새로운. Xcode 27.0는 지원됩니다.
2. Xcode > 설정 > Intelligence > Model Context Protocol, 활성화

Xcode MCP Bridge Wrapper

mcpbridge-wrapper connects external MCP clients to Xcode through Apple’s xcrun mcpbridge. It repairs Xcode tool responses that declare an outputSchema but omit structuredContent. The repair works in both direct and broker modes. Broker mode also lets several clients share one persistent Xcode connection, reducing repeated connection prompts.

Compatibility

The wrapper does not bundle Xcode tools. It exposes the catalog returned by the installed Xcode, so tool names and availability can change with Xcode updates and permissions. The Xcode 27.0 catalog observed with build 27A266a is listed below.

Quick Start

1. Install uv and Xcode 26.3 or newer. Xcode 27.0 is supported.
2. In Xcode > Settings > Intelligence > Model Context Protocol, enable Allow external agents to use Xcode tools. Open the project you want to use in Xcode. See Apple’s setup guide.
3. Add one of the client configurations below. Pin 0.5.0 to keep the legacy MCP contract when a future major release becomes available.
4. Start the client and approve the Xcode access prompt if shown. After approval, reload or reconnect the MCP server in the client so it fetches tools/list again, then verify with a real Xcode tool call. A green MCP indicator alone only confirms the handshake.

Broker mode is recommended for multiple clients. All examples use the same per-user daemon. The first client starts it; subsequent clients reuse it.

Cursor

Add to ~/.cursor/mcp.json:

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

Codex

Add to ~/.codex/config.toml and restart Codex:

[mcp_servers.xcode-tools]
command = "uvx"
args = ["--from", "mcpbridge-wrapper==0.5.0", "mcpbridge-wrapper", "--broker"]

Zed