Xcode: обёртка MCP-моста для Cursor
Xcode: обёртка MCP-моста для Cursor — MCP-сервер сообщества (автор — SoundBlaster). Обёртка на Python, которая делает MCP-мост Xcode совместимым со строгими клиентами вроде Cursor. Ставится через uvx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- SoundBlaster
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- python
Уровень риска: high
Инструменты Xcode пишут и удаляют файлы, меняют настройки сборки, запускают приложение и отладчик. Подтверждайте доступ только для ожидаемого проекта.
Настройка клиентов
{
"code": "[mcp_servers.xcode-tools]\ncommand = \"uvx\"\nargs = [\"--from\", \"mcpbridge-wrapper==0.5.0\", \"mcpbridge-wrapper\", \"--broker\"]",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
mcpbridge-wrapper (проект xcodemcpwrapper) подключает внешние MCP-клиенты к Xcode через штатный мост Apple xcrun mcpbridge. Он исправляет ответы инструментов Xcode, которые объявляют outputSchema, но не возвращают structuredContent, — без этого часть клиентов не может прочитать результат. Исправление работает в прямом режиме и в режиме брокера. В режиме брокера несколько клиентов делят одно постоянное подключение к Xcode, поэтому запросы на доступ появляются реже.
Своих инструментов обёртка не добавляет: она отдаёт каталог установленного Xcode, поэтому набор может меняться с обновлениями Xcode и разрешениями. В Xcode 27.0 автор видел такие группы:
- Рабочие пространства и цели: открытие и закрытие проектов, новые проекты и цели, схемы, устройства запуска, тест-планы.
- Файлы и диагностика: чтение, запись, правка, поиск, перемещение и удаление файлов, обновление ошибок кода.
- Сборка, тесты, запуск и отладка:
BuildProject, журнал сборки, запуск всех или выбранных тестов,RunProject, вывод консоли, команды отладчика, настройки сборки. - Работа с устройством: сессии, установка и запуск приложения, имитация действий.
- Локализация: каталоги строк — чтение и правка.
- Сбои и производительность: главные сбои и проблемы производительности с журналами.
- Превью и справка:
RenderPreview,DocumentationSearch,RunCodeSnippet, а также права приложения и Info.plist.
Кому подойдёт
- iOS- и macOS-разработчикам, которые хотят работать с Xcode из Cursor, Codex, Zed или Claude Code.
- Тем, у кого несколько агентов одновременно: брокер избавляет от повторных запросов доступа.
- Тем, чей клиент не понимает ответы Xcode без
structuredContent.
Похожие серверы — в категории разработка.
Установка
Нужны macOS, Xcode 26.3 или новее (Xcode 27.0 поддерживается), uv и Python 3.9–3.12 — uvx сам управляет окружением. В Xcode откройте Settings → Intelligence → Model Context Protocol и включите Allow external agents to use Xcode tools, затем откройте нужный проект. README советует закрепить версию 0.5.0, чтобы будущий мажорный выпуск не сменил протокол. Новую версию протокола MCP 2026-07-28 выпуск 0.5.0 не поддерживает.
Подключение к клиентам
Конфиги приведены дословно из README. Все примеры используют один брокер на пользователя: первый клиент запускает его, следующие подключаются к нему же. Для одного клиента можно убрать --broker и работать напрямую. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"xcode-tools": {
"command": "uvx",
"args": ["--from", "mcpbridge-wrapper==0.5.0", "mcpbridge-wrapper", "--broker"]
}
}
}Проверка
Запустите клиент и подтвердите запрос доступа в Xcode. Затем переподключите сервер, чтобы клиент заново получил список инструментов, и сделайте настоящий вызов инструмента Xcode. Зелёный индикатор MCP означает только успешное рукопожатие. Состояние можно проверить командой uvx --from 'mcpbridge-wrapper==0.5.0' mcpbridge-wrapper --broker-status.
Примеры задач
Собери проект и покажи ошибки из журнала сборки.Запусти тесты модуля авторизации и объясни, почему падают.Риски
Через обёртку агент получает инструменты Xcode, которые пишут и удаляют файлы, меняют настройки сборки, запускают приложение и команды отладчика. Xcode 27.0 запрашивает доступ для процесса брокера и папки проекта, причём в запросе указан исполняемый файл Python и PID, а не название редактора.
Как снизить риски: подтверждайте доступ, только если путь и проект ожидаемые. Начинайте с вызовов только для чтения при проверке новой настройки. Остановка брокера (--broker-stop) временно отключает все клиенты, которые им пользуются. Лицензия — MIT.
Частые вопросы
Почему инструменты отличаются от списка в README?
Обёртка отдаёт каталог установленного Xcode. Имена и состав инструментов меняются с версией Xcode и разрешениями.
Нужен ли брокер, если клиент один?
Нет. Уберите --broker из команды, и обёртка будет работать в прямом режиме.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.