$git clone https://github.com/kimsungwhee/apple-docs-mcpApple Developer Documentation MCP Server - Access Apple's official developer docs, frameworks, APIs, SwiftUI, UIKit, and WWDC videos through Model Context Protocol. Search iOS, macOS, watchOS, tvOS, and visionOS documentation with AI-powered natural language queries. Get instant
| 1 | # Apple Docs MCP - Apple Developer Documentation Model Context Protocol Server |
| 2 | |
| 3 | [](https://badge.fury.io/js/@kimsungwhee%2Fapple-docs-mcp) |
| 4 | [](https://opensource.org/licenses/MIT) |
| 5 | |
| 6 | Apple Developer Documentation MCP Server - Access Apple's official developer docs, frameworks, APIs, SwiftUI, UIKit, and WWDC videos through Model Context Protocol. Search iOS, macOS, watchOS, tvOS, and visionOS documentation with AI-powered natural language queries. Get instant access to Swift/Objective-C code examples, API references, and technical guides directly in Claude, Cursor, or any MCP-compatible AI assistant. |
| 7 | |
| 8 | **English** | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh-CN.md) |
| 9 | |
| 10 | ## ✨ Features |
| 11 | |
| 12 | - 🔍 **Smart Search**: Intelligent search across Apple Developer Documentation for SwiftUI, UIKit, Foundation, CoreData, ARKit, and more |
| 13 | - 📚 **Complete Documentation Access**: Full access to Apple's JSON API for Swift, Objective-C, and framework documentation |
| 14 | - 🔧 **Framework Index**: Browse hierarchical API structures for iOS, macOS, watchOS, tvOS, visionOS frameworks |
| 15 | - 📋 **Technology Catalog**: Explore Apple technologies including SwiftUI, UIKit, Metal, Core ML, Vision, and ARKit |
| 16 | - 📰 **Documentation Updates**: Track WWDC 2024/2025 announcements, iOS 26, macOS 26, and latest SDK releases |
| 17 | - 🎯 **Technology Overviews**: Comprehensive guides for Swift, SwiftUI, UIKit, and all Apple development platforms |
| 18 | - 💻 **Sample Code Library**: Swift and Objective-C code examples for iOS, macOS, and cross-platform development |
| 19 | - 🎥 **WWDC Video Library**: Search WWDC 2014-2025 sessions with transcripts, Swift/SwiftUI code examples, and resources |
| 20 | - 🔗 **Related APIs Discovery**: Find SwiftUI views, UIKit controllers, and framework-specific API relationships |
| 21 | - 📊 **Platform Compatibility**: iOS 13+, macOS 10.15+, watchOS 6+, tvOS 13+, visionOS compatibility analysis |
| 22 | - ⚡ **High Performance**: Optimized for Xcode, Swift Playgrounds, and AI-powered development environments |
| 23 | - 🔄 **Smart UserAgent Pool**: Intelligent UserAgent rotation system with automatic failure recovery and performance monitoring |
| 24 | - 🌐 **Multi-Platform**: Complete iOS, iPadOS, macOS, watchOS, tvOS, and visionOS documentation support |
| 25 | - 🏷️ **Beta & Status Tracking**: iOS 26 beta APIs, deprecated UIKit methods, new SwiftUI features tracking |
| 26 | |
| 27 | ## 🚀 Quick Start |
| 28 | |
| 29 | ### Claude Desktop (Recommended) |
| 30 | |
| 31 | Add this to your Claude Desktop configuration: |
| 32 | |
| 33 | **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` |
| 34 | **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` |
| 35 | |
| 36 | ```json |
| 37 | { |
| 38 | "mcpServers": { |
| 39 | "apple-docs": { |
| 40 | "command": "npx", |
| 41 | "args": ["-y", "@kimsungwhee/apple-docs-mcp"] |
| 42 | } |
| 43 | } |
| 44 | } |
| 45 | ``` |
| 46 | |
| 47 | > **Note**: If you encounter issues with an old version being used, add `@latest` to force the latest version: |
| 48 | > ```json |
| 49 | > "args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"] |
| 50 | > ``` |
| 51 | |
| 52 | Restart Claude Desktop and start asking about Apple APIs! |
| 53 | |
| 54 | ## 📦 Installation |
| 55 | |
| 56 | <details> |
| 57 | <summary><strong>📱 Claude Code</strong></summary> |
| 58 | |
| 59 | ```bash |
| 60 | claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest |
| 61 | ``` |
| 62 | |
| 63 | [📖 Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) |
| 64 | |
| 65 | </details> |
| 66 | |
| 67 | <details> |
| 68 | <summary><strong>🖱️ Cursor</strong></summary> |
| 69 | |
| 70 | **Via Settings**: Settings → Cursor Settings → MCP → Add new global MCP server |
| 71 | |
| 72 | **Via Config File**: Add to `~/.cursor/mcp.json`: |
| 73 | |
| 74 | ```json |
| 75 | { |
| 76 | "mcpServers": { |
| 77 | "apple-docs": { |
| 78 | "command": "npx", |
| 79 | "args": ["-y", "@kimsungwhee/apple-docs-mcp"] |
| 80 | } |
| 81 | } |
| 82 | } |
| 83 | ``` |
| 84 | |
| 85 | [📖 Cursor MCP docs](https://docs.cursor.com/context/mcp) |
| 86 | |
| 87 | </details> |
| 88 | |
| 89 | <details> |
| 90 | <summary><strong>🔷 VS Code</strong></summary> |
| 91 | |
| 92 | Add to your VS Code MCP config: |
| 93 | |
| 94 | ```json |
| 95 | { |
| 96 | "mcp": { |
| 97 | "servers": { |
| 98 | "apple-docs": { |
| 99 | "type": "stdio", |
| 100 | "command": "npx", |
| 101 | "args": ["-y", "@kimsungwhee/apple-docs-mcp"] |