apple-docs MCP server
2026년 10월 14일 커밋AI 클라이언트가 Apple 개발자 문서, WWDC 세션, Human Interface Guidelines를 깔끔한 Markdown 형식으로 검색하고 가져올 수 있도록 지원합니다.
다른 이름 zmscode/apple-docs-mcp
- 스타
- 2
- Tools
- 5
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 14일
- 라이선스
- MIT
apple-docs MCP란?
AI 클라이언트가 Apple 개발자 문서, WWDC 세션, Human Interface Guidelines를 깔끔한 Markdown 형식으로 검색하고 가져올 수 있도록 지원합니다. 5개 도구를 제공합니다. 예: search_docs, get_doc, browse_framework.
프로젝트 README에서 생성된 요약
apple-docs MCP server 정보
macOS, iOS 또는 other Apple 플랫폼용 앱을 개발하는 개발자는 AI 클라이언트를 통해 공식 기술 문서에 직접 접근할 수 있습니다. Swift 기반의 이 MCP server는 SwiftUI, AppKit, UIKit, Foundation, SwiftData를 포함하여 developer.apple.com의 콘텐츠를 가져옵니다. 복잡한 문서를 깔끔한 Markdown으로 변환하여 모델이 코딩 작업에서 쉽게 파싱하고 사용할 수 있도록 합니다.
사용자는 심볼, 아티클, 샘플 코드에 대해 전체 텍스트 검색을 수행하거나 browse_framework 도구를 사용하여 프레임워크의 전체 심볼 트리를 탐색할 수 있습니다. 또한 이 서버는 WWDC 비디오 콘텐츠를 처리하며, get_video 도구를 통해 설명, 챕터 요약 및 타임스탬프가 포함된 스크립트를 제공합니다. macOS 13 이상에서의 로컬 설치와 Claude Desktop 또는 Claude Code와 같은 클라이언트와의 통합을 모두 지원합니다.
표준 문서를 넘어 Human Interface Guidelines에 대한 접근을 제공하며 Objective-C 전용 뷰도 지원합니다. 응답을 메모리에 6시간 동안 캐싱하여 데이터를 효율적으로 관리하며, 네트워크 안정성을 위한 내장 재시도 로직을 포함하고 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
apple-docs MCP 도구 5
README에서 감지됨search_docsget_docbrowse_frameworkget_videolist_frameworks
| search_docs | — | |
| get_doc | — | |
| browse_framework | — | |
| get_video | — | |
| list_frameworks | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능zmscode/apple-docs-mcp is public and reachablegithub.com/zmscode/apple-docs-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-14github.com/zmscode/apple-docs-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음5 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기apple-docs-mcp
An MCP server, written in Swift, for Apple developer documentation: SwiftUI, AppKit, UIKit, Foundation, SwiftData, the Human Interface Guidelines, and every other framework on developer.apple.com. Pages come back as clean Markdown.
Tools
| Tool | What it does |
|---|---|
search_docs |
Full-text search of developer.apple.com: symbols, articles, sample code, and WWDC videos. Filters: framework (also adds exact symbol-name matches from that framework's index), type (documentation, sample_code, video), and platform (for example "macOS 14"). |
get_doc |
Fetches a page as Markdown: declaration, availability, overview, parameters, code samples, topics, relationships, and sample code download links. Accepts a URL, a path (swiftui/view), a doc:// id, or a dotted name (AppKit.NSWindow). Options: language: "objc", topics (compact, full, none), section (for example "Overview" or a Topics group like "Handling Mouse Events"), hide_deprecated, and offset/max_chars for paging through long pages. |
browse_framework |
Searches or outlines a framework's whole symbol tree, for example every NSTableView* in AppKit. Works for the Human Interface Guidelines ("HIG"). Filters: query, kind, path, depth, language, hide_deprecated, hide_beta. |
get_video |
Fetches a WWDC session: description, chapter summaries, and code snippet titles by default. Use include: "code" for the code, "transcript" for the timestamped transcript, or "all". Accepts a URL or an id like wwdc2025-256. |
list_frameworks |
Lists all of Apple's documented technologies. |
Every tool returns Markdown for the model plus structured content that matches its declared outputSchema, for clients that use it.
Resources
Pages can also be attached as MCP resources:
| URI | Content |
|---|---|
apple-docs://doc/{path} |
A documentation page, e.g. apple-docs://doc/swiftui/navigationstack. Add ?language=objc for Objective-C. |
apple-docs://video/{id} |
A WWDC session, e.g. apple-docs://video/wwdc2025-256. Add ?include=transcript, code, or all. |
apple-docs://framework/{name} |
A framework's table of contents, e.g. apple-docs://framework/appkit or apple-docs://framework/hig. |
developer.apple.com URLs work as resource URIs too. The server lists the SwiftUI, AppKit, UIKit, Foundation, SwiftData, Observation, Swift, and HIG landing pages as ready-made resources.
Install
Requires macOS 13 or later and Swift 6 (Xcode or the Command Line Tools).
git clone https://github.com/zmscode/apple-docs-mcp.git
cd apple-docs-mcp
make install
This builds a release binary and installs it to ~/.local/bin/apple-docs-mcp. Set PREFIX to install somewhere else. Run it again after any change. Then restart Claude Desktop (⌘Q) and start a new Claude Code session to pick up the update.
Claude Code
claude mcp add --scope user apple-docs -- ~/.local/bin/apple-docs-mcp
Claude Desktop or another client
{
"mcpServers": {
"apple-docs": { "command": "/Users/you/.local/bin/apple-docs-mcp" }
}
}
For Claude Desktop, this goes in ~/Library/Application Support/Claude/claude_desktop_config.json.
Development
| Command | What it does |
|---|---|
make test |
Unit and end-to-end tests against saved fixtures. The first run downloads the fixtures and records the snapshots; after that, no network is needed. |
make test-live |
Checks the real developer.apple.com, to catch format changes the fixtures can't. |
make fixtures |
Re-downloads the fixtures. Follow with make snapshots and review the snapshot diff, which shows how Apple's format changed. |
make snapshots |
Re-records the Markdown snapshots in Tests/AppleDocsKitTests/Fixtures/Snapshots after an intentional rendering change. |
The fixtures are copies of Apple's pages, so they aren't checked in. Snapshots are rendered from them, so they're recorded locally too: they catch changes from your own edits, and from Apple's format after a make fixtures.
Use make test rather than plain swift test. With the Command Line Tools (no Xcode), SwiftPM passes the testing macro plugin path in a form the compiler can't use, so incremental test builds fail with "plugin for module 'TestingMacros' not found". The Makefile works around it.
The code lives in the AppleDocsKit library. Sources/AppleDocsMCP/main.swift just starts the server.
| File | Contents |
|---|---|
Server.swift |
Server setup, plus resources |
Tools.swift |
Tool definitions, search_docs, get_doc, list_frameworks, and pagination |
Browse.swift |
browse_framework, and loading framework trees |
Videos.swift |
get_video, and parsing video pages |
Renderer.swift |
Converts DocC JSON to Markdown, and applies Objective-C variants |
DocsClient.swift |
Networking, retries, caching, and search stream parsing |
Output.swift |
Structured output types and their JSON Schemas |
Configuration
| Environment variable | Purpose |
|---|---|
APPLE_DOCS_SEARCH_URL |
Overrides the search endpoint if Apple moves it. The current value is in the SEARCH_CONFIG script on developer.apple.com/search. |
How it works
- Pages are fetched as DocC render JSON from
developer.apple.com/tutorials/data/<path>.jsonand converted to Markdown. - Framework trees come from
developer.apple.com/tutorials/data/index/<framework>. Content without an index, like the Human Interface Guidelines, is outlined by following topic sections from its landing page. - Objective-C pages are produced by applying the page's
variantOverridespatches. - Video pages are HTML only, so
get_videodepends on the page's class names (supplement summary,transcript-content, and so on).make test-livewill flag it if Apple redesigns them. - Search uses the same backend as developer.apple.com/search. Apple doesn't document this endpoint, so it could change. If it fails,
search_docsfalls back to title matches from framework symbol lists (the named framework, or SwiftUI, AppKit, UIKit, and Foundation), and says so in its output. - Requests time out after 20 seconds. Timeouts, dropped connections, 429s, and 5xx responses are retried with backoff. Concurrent requests for the same URL share one download.
- Responses are cached in memory for 6 hours, up to 48 MB in total, evicting the least recently used first.
License
MIT. This project isn't affiliated with Apple; documentation content is fetched from developer.apple.com at run time and belongs to Apple.
apple-docs MCP 질문
apple-docs MCP는 어떤 도구를 제공하나요?
5개 도구를 제공합니다. 예: search_docs, get_doc, browse_framework, get_video, list_frameworks.
어떤 Apple 프레임워크를 지원하나요?
SwiftUI, AppKit, UIKit, Foundation, SwiftData, Observation, Swift 및 Human Interface Guidelines를 지원합니다.
WWDC 세션 스크립트를 어떻게 가져오나요?
get_video 도구를 사용하고 include 파라미터를 'transcript'로 설정하면 타임스탬프가 포함된 스크립트를 가져올 수 있습니다.
설치를 위한 시스템 요구 사항은 무엇인가요?
macOS 13 이상과 Swift 6가 필요하며, Xcode 또는 Command Line Tools를 통해 설치할 수 있습니다.
Objective-C 문서를 지원하나요?
네, language 옵션을 사용하거나 리소스 URI에 language 파라미터를 추가하여 Objective-C 버전의 페이지를 가져올 수 있습니다.