SX

soundblaster/xcodemcpwrapper

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

20 stars 2 forks Качество 79 Тренд 18MIT

MCP делает Xcode 26.3 совместимым с Cursor и другими строгими MCP-специальными клиентами

Обзор

mcpbridge-wrapper соединяет внешние MCP-клиенты с Xcode через Apple xcrun mcpbridge. Он восстанавливает ответы инструмента Xcode, которые объявляют схему вывода, но опускают структурированный контент. Ремонт работает как в прямом, так и в брокерском режимах. Режим брокера также позволяет нескольким клиентам использовать одно постоянное соединение Xcode, уменьшая количество повторных запросов на соединение. Обертка делает набор инструментов Xcode. Он раскрывает каталог, возвращенный установленным Xcode, поэтому имена инструментов и доступность могут меняться с обновлениями и разрешениями Xcode. Каталог Xcode 27.0 с сборкой 27A266a приведен ниже. 1.Установите uv и Xcode 26.3 или новее. Поддерживается Xcode 27.0. 2.Включить. Откройте проект, который вы хотите использовать в Xcode. См. руководство по настройке Apple. 3. Добавить одну из клиентских конфигураций ниже. Pin 0.5.0 сохранит унаследованный контракт MCP, когда станет доступен будущий крупный релиз. 4.Запустите клиент и одобрите подсказку доступа Xcode, если она показана.

Обзор (машинный перевод)

T0 подключает внешние MCP-клиенты к Xcode через Apple [[Т1]]. Он восстанавливает ответы инструмента Xcode, которые объявляют [2], но опустить [3]. Ремонтные работы в обоих направлениях и брокерские режимы. Режим брокера также позволяет нескольким клиентам делиться одним постоянным. Соединение Xcode, уменьшающее повторные подсказки соединения.

##Совместимость

| Компонент | Поддержка 0,5.0 | [править править код] | Xcode | 26.3+ и 27.0 на macOS; Xcode 27.0 рукопожатие и обнаружение инструмента проверены Клиенты, использующие жизненный цикл initialize; проверьте протокол, используемый вашей клиентской версией | MCP 2026-07-28 | Не поддерживается 0,5.0; бессессионная реализация остается экспериментальной на отдельной ветке | Python 3.9-3.12; [T5] управляет собственной средой

Обертка делает не пакет инструментов Xcode. Он раскрывает каталог, возвращенный Установленный Xcode, поэтому имена инструментов и доступность могут меняться с помощью Xcode. Обновления и разрешения. Каталог Xcode 27.0 наблюдался со сборкой 27A266a перечислены ниже.

Быстрый старт

1.Установить uv и Xcode 26.3 или новее. Поддерживается Xcode 27.0. 2. В Xcode > Настройки > Intelligence > Model Context Protocol

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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

Component Support in 0.5.0
Xcode 26.3+ and 27.0 on macOS; Xcode 27.0 handshake and tool discovery verified
MCP clients Clients using the initialize lifecycle; check the protocol used by your client version
MCP 2026-07-28 Not supported by 0.5.0; the sessionless implementation remains experimental on a separate branch
Python 3.9-3.12; uvx manages its own environment

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

Открыть полный README на GitHub

Установка

uvx --from mcpbridge-wrapper==0.5.0 mcpbridge-wrapper --broker
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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