Apple Doc MCP
MCP-сервер дает агенту искать символы и читать документацию Apple для разработчиков: SwiftUI, UIKit и другие фреймворки
- 632 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер загружает страницы документации Apple из сети
- Загруженные страницы он сохраняет на диск в папку `.cache/`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/apple-doc-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер загружает страницы документации Apple из сети
- Загруженные страницы он сохраняет на диск в папку `.cache/`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Агент, который пишет код под iOS или macOS, может перепутать названия типов и модификаторов SwiftUI. Apple Doc MCP отдает ему справку из документации Apple для разработчиков, поэтому он сверяет API с первоисточником. Сервер работает по MCP и запускается через `npx apple-doc-mcp-server@latest`. Работа идет в три шага. Инструмент discover_technologies показывает список фреймворков с фильтром, choose_technology делает выбранный фреймворк активным, и без этого поиск не работает. После этого search_symbols ищет символы, а get_documentation открывает подробную страницу известного символа или пути в документации. Поиск рассчитан на агента. Точные имена вроде GridItem, View или ButtonStyle находятся сразу, подстановочные знаки `*` и `?` работают как в оболочке, а статьи и руководства идут отдельным блоком после символов. Загруженные страницы документации сервер кэширует в папке `.cache/`. Инструмент current_technology подсказывает, какой фреймворк выбран сейчас, а get_version показывает версию сервера.
Для кого. Разработчикам под iOS и macOS, которые пишут на SwiftUI и UIKit вместе с агентом и хотят, чтобы он сверялся со справкой Apple.
Подходит, если
- Агент предлагает модификатор SwiftUI, которого не существует, и нужно сверить его с документацией
- Нужно найти все символы по маске, например `Grid*` или `*Item`, и увидеть, какие из них относятся к компоновке
- Нужно открыть страницу известного типа, такого как ButtonStyle, и прочитать описание с параметрами
- Вы не знаете точного названия API и ищете по синониму: sheet или modal, toolbar или tabbar
- Вы подбираете фреймворк под задачу и хотите пролистать список технологий Apple с фильтром по ключевому слову
Не подходит, если
- Нужны документы сторонних библиотек или других платформ: сервер читает только документацию Apple
- Нужна работа без сети: сервер загружает страницы документации Apple и сохраняет их в кэш
- Вопрос концептуальный, например «как устроена архитектура приложения»: сервер отвечает по символам и статьям и практики не пересказывает
- Нужен разбор кода SwiftUI и подсказки по состоянию и производительности: для этого есть скиллы с практиками, а сервер дает справку
Пример запроса к агенту
Найди в документации Apple символы по маске Grid*, открой описание GridItem и покажи, какие параметры у его инициализатораMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужен Node.js, чтобы запустить пакет через npx. Перед поиском обязательно выберите фреймворк инструментом choose_technology: без активной технологии поиск по символам не работает. Если запрос ничего не нашел, повторите discover_technologies с другим ключевым словом или выберите другой фреймворк.
Для локальной установки из исходников выполните `yarn install` и `yarn build`, затем укажите в конфигурации клиента абсолютный путь к `dist/index.js`. Доступность документации Apple для разработчиков из России при подготовке карточки не проверялась.
Как отключить. В Claude Code выполните `claude mcp remove apple-docs`. В Codex уберите сервер командой `codex mcp remove apple-doc-mcp`, в других клиентах удалите блок apple-docs из конфигурации MCP. Кэш документации лежит в папке `.cache/` и удаляется вручную.
Частые вопросы
Как поставить Apple Doc MCP в Claude Code?
Выполните `claude mcp add apple-docs -- npx apple-doc-mcp-server@latest`. Для OpenAI Codex команда другая: `codex mcp add apple-doc-mcp -- npx apple-doc-mcp-server@latest`. В VS Code откройте палитру команд, выберите `MCP: Add Server`, тип npm и введите имя пакета apple-doc-mcp-server.
Почему поиск символов ничего не возвращает?
Сначала нужно выбрать фреймворк инструментом choose_technology, иначе активной технологии нет. Если выбор сделан, а результатов нет, запустите discover_technologies с другим ключевым словом или выберите другой фреймворк. Помогает и поиск по синониму, например sheet вместо modal.
Какие инструменты есть у Apple Doc MCP?
Шесть: discover_technologies, choose_technology, current_technology, search_symbols, get_documentation и get_version. Первые два задают фреймворк, search_symbols ищет по нему, get_documentation открывает страницу, а остальные показывают текущий выбор и версию сервера.
Работают ли в поиске маски вроде Grid*?
Да. Подстановочные знаки `*` и `?` учитываются при поиске. Точные имена, такие как GridItem, View и ButtonStyle, находятся напрямую, а статьи и руководства выводятся отдельным разделом после символов.
Что изменилось в версии 1.9.6?
Поиск символов упростили, чтобы он вел себя предсказуемее для агентов: добавили точное разрешение имен, вывод сначала символов, а потом статей, и починили подстановочные знаки. Кроме того, исправили инициализацию индекса при первом поиске и убрали вводящие в заблуждение сообщения о фоновой загрузке.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к официальной документации Apple: поиск по фреймворкам, API, примерам кода и сессиям WWDC прямо из агента
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
MCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
XcodeBuildMCP (теперь MobileBuildMCP)
XcodeBuildMCP
MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
MCP-сервер управляет реальным iPhone через macOS iPhone Mirroring: агент видит экран, нажимает, листает и вводит текст
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Apple Doc MCP (эта запись) | нет | не нужна | 632 | |
| Context Hub | нет | 13 986 | CLI с отобранной документацией API по версиям и языкам для разных платформ | |
| SwiftUI Expert Skill | нет | 3 781 | скилл с практиками SwiftUI: состояние, композиция, производительность |
Коротко о README
README коротко представляет сервер как доступ к документации Apple для разработчиков из ассистента для кода. Дальше идут история последних версий с исправлениями поиска, команды установки для VS Code, Claude Code, Codex и ручной конфигурации, а также запуск из локальной сборки. В конце собраны советы по запросам и список из шести инструментов.