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 пишут и удаляют файлы, меняют настройки сборки, запускают приложение и отладчик. Подтверждайте доступ только для ожидаемого проекта.

Настройка клиентов

codex
{
    "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.

~/.cursor/mcp.json
{
  "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники