
soundblaster/xcodemcpwrapper
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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
- Install uv and Xcode 26.3 or newer. Xcode 27.0 is supported.
- 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.
- Add one of the client configurations below. Pin
0.5.0to keep the legacy MCP contract when a future major release becomes available. - 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/listagain, 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
Установка
uvx --from mcpbridge-wrapper==0.5.0 mcpbridge-wrapper --brokerКонфигурация
{
"mcpServers": {
"xcode-tools": {
"command": "uvx",
"args": ["--from", "mcpbridge-wrapper==0.5.0", "mcpbridge-wrapper", "--broker"]
}
}
}