kimsungwhee/apple-docs-mcp
If you are the rightful owner of apple-docs-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Apple Docs MCP is a Model Context Protocol server that enables seamless access to Apple Developer Documentation through natural language queries.
Apple Docs MCP - Apple Developer Documentation Model Context Protocol Server
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.
English | | |
โจ Features
- ๐ Smart Search: Intelligent search across Apple Developer Documentation for SwiftUI, UIKit, Foundation, CoreData, ARKit, and more
- ๐ Complete Documentation Access: Full access to Apple's JSON API for Swift, Objective-C, and framework documentation
- ๐ง Framework Index: Browse hierarchical API structures for iOS, macOS, watchOS, tvOS, visionOS frameworks
- ๐ Technology Catalog: Explore Apple technologies including SwiftUI, UIKit, Metal, Core ML, Vision, and ARKit
- ๐ฐ Documentation Updates: Track WWDC 2024/2025 announcements, iOS 26, macOS 26, and latest SDK releases
- ๐ฏ Technology Overviews: Comprehensive guides for Swift, SwiftUI, UIKit, and all Apple development platforms
- ๐ป Sample Code Library: Swift and Objective-C code examples for iOS, macOS, and cross-platform development
- ๐ฅ WWDC Video Library: Search WWDC 2014-2025 sessions with transcripts, Swift/SwiftUI code examples, and resources
- ๐ Related APIs Discovery: Find SwiftUI views, UIKit controllers, and framework-specific API relationships
- ๐ Platform Compatibility: iOS 13+, macOS 10.15+, watchOS 6+, tvOS 13+, visionOS compatibility analysis
- โก High Performance: Optimized for Xcode, Swift Playgrounds, and AI-powered development environments
- ๐ Multi-Platform: Complete iOS, iPadOS, macOS, watchOS, tvOS, and visionOS documentation support
- ๐ท๏ธ Beta & Status Tracking: iOS 26 beta APIs, deprecated UIKit methods, new SwiftUI features tracking
๐ Quick Start
Claude Desktop (Recommended)
Add this to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
Note: If you encounter issues with an old version being used, add
@latest
to force the latest version:"args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"]
Restart Claude Desktop and start asking about Apple APIs!
๐ฆ Installation
๐ฑ Claude Code
claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest
๐ฑ๏ธ Cursor
Via Settings: Settings โ Cursor Settings โ MCP โ Add new global MCP server
Via Config File: Add to ~/.cursor/mcp.json
:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
๐ท VS Code
Add to your VS Code MCP config:
{
"mcp": {
"servers": {
"apple-docs": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
}
๐ Windsurf
Add to your Windsurf MCP config:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
โก Zed
Add to your Zed settings.json
:
{
"context_servers": {
"Apple Docs": {
"command": {
"path": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
},
"settings": {}
}
}
}
๐ง Cline
Via Marketplace:
- Open Cline โ Menu (โฐ) โ MCP Servers โ Marketplace
- Search "Apple Docs MCP" โ Install
Via Config: Add to cline_mcp_settings.json
:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
๐ช Windows
For Windows systems, use:
{
"mcpServers": {
"apple-docs": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
โ๏ธ Advanced Installation
Global Installation:
# Using pnpm (recommended)
pnpm add -g @kimsungwhee/apple-docs-mcp
# Using npm
npm install -g @kimsungwhee/apple-docs-mcp
Direct Usage:
npx @kimsungwhee/apple-docs-mcp --help
Development Setup:
git clone https://github.com/kimsungwhee/apple-docs-mcp.git
cd apple-docs-mcp
# Using pnpm (recommended)
pnpm install && pnpm run build
# Using npm
npm install && npm run build
๐ฌ Usage Examples
๐ Smart Search
"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Look up async/await patterns in Swift"
"Show me UITableView delegate methods"
"Search Core Data NSPersistentContainer examples"
"Find AVFoundation video playback APIs"
๐ Documentation Access
"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Get platform compatibility for SwiftData"
"Access UIViewController documentation with similar APIs"
"Show me NSManagedObjectContext documentation"
"Get URLSession async/await methods"
๐ง Framework Exploration
"Show me SwiftUI framework API index"
"List all UIKit classes and methods"
"Browse ARKit framework structure"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"
"Show Vision framework image analysis APIs"
๐ API Discovery
"Find APIs related to UIViewController"
"Show me similar APIs to withAnimation"
"Get all references from SwiftData documentation"
"Discover alternatives to Core Data NSManagedObject"
๐ Technology & Platform Analysis
"List all Beta frameworks in iOS 26"
"Show me Graphics & Games technologies"
"What machine learning frameworks are available?"
"Analyze platform compatibility for Vision framework"
๐ฐ Documentation Updates
"Show me the latest WWDC updates"
"What's new in SwiftUI?"
"Get technology updates for iOS"
"Show me release notes for Xcode"
"Find beta features in the latest updates"
๐ฏ Technology Overviews
"Show me technology overviews for app design and UI"
"Get comprehensive guides for games development"
"Explore AI and machine learning overviews"
"Show me iOS-specific technology guides"
"Get data management technology overviews"
๐ป Sample Code Library
"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get UIKit example projects"
"Show featured WWDC sample code"
"Find Core Data sample implementations"
"Show only beta sample code projects"
๐ฅ WWDC Video Search
"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2024 videos"
"Search for async/await WWDC talks"
"Find WWDC videos about Swift concurrency"
"Show accessibility-focused WWDC sessions"
๐บ WWDC Video Details
"Get details for WWDC session 10176"
"Show me the transcript for WWDC23 session on SwiftData"
"Get code examples from WWDC video 10019"
"Show resources from Vision Pro WWDC session"
"Get transcript for 'Meet async/await in Swift' session"
๐ WWDC Topics & Years
"List all WWDC topics"
"Show me Swift topic WWDC videos"
"Get WWDC videos about developer tools"
"List WWDC videos from 2023"
"Show all SwiftUI and UI frameworks sessions"
"Get machine learning WWDC content"
๐ ๏ธ Advanced Usage
"Find related APIs for @State with platform analysis"
"Resolve all references from SwiftUI documentation"
"Get platform compatibility analysis for Vision framework"
"Find similar APIs to UIViewController with deep search"
๐ ๏ธ Available Tools
Tool | Description | Key Features |
---|---|---|
search_apple_docs | Search Apple Developer Documentation | Official search API, find specific APIs, classes, methods |
get_apple_doc_content | Get detailed documentation content | JSON API access, optional enhanced analysis (related/similar APIs, platform compatibility) |
list_technologies | Browse all Apple technologies | Category filtering, language support, beta status |
search_framework_symbols | Search symbols in specific framework | Classes, structs, protocols, wildcard patterns, type filtering |
get_related_apis | Find related APIs | Inheritance, conformance, "See Also" relationships |
resolve_references_batch | Batch resolve API references | Extract and resolve all references from documentation |
get_platform_compatibility | Platform compatibility analysis | Version support, beta status, deprecation info |
find_similar_apis | Discover similar APIs | Apple's official recommendations, topic groupings |
get_documentation_updates | Track Apple documentation updates | WWDC announcements, technology updates, release notes |
get_technology_overviews | Get technology overviews and guides | Comprehensive guides, hierarchical navigation, platform filtering |
get_sample_code | Browse Apple sample code projects | Framework filtering (with limitations), keyword search, beta status |
search_wwdc_videos | Search WWDC video sessions | Keyword search, topic/year filtering, session metadata |
get_wwdc_video_details | Get WWDC video details with transcript | Full transcripts, code examples, resources, platform info |
list_wwdc_topics | List all available WWDC topics | 19 topic categories from Swift to Spatial Computing |
list_wwdc_years | List all available WWDC years | Conference years with video counts |
๐๏ธ Technical Architecture for Apple Developer Documentation Access
apple-docs-mcp/
โโโ ๐ง src/
โ โโโ index.ts # MCP server entry point with all tools
โ โโโ tools/ # MCP tool implementations
โ โ โโโ search-parser.ts # HTML search result parsing
โ โ โโโ doc-fetcher.ts # JSON API documentation fetching
โ โ โโโ list-technologies.ts # Technology catalog handling
โ โ โโโ get-documentation-updates.ts # Documentation updates tracking
โ โ โโโ get-technology-overviews.ts # Technology overviews and guides
โ โ โโโ get-sample-code.ts # Sample code library browser
โ โ โโโ get-framework-index.ts # Framework structure indexing
โ โ โโโ get-related-apis.ts # Related API discovery
โ โ โโโ resolve-references-batch.ts # Batch reference resolution
โ โ โโโ get-platform-compatibility.ts # Platform analysis
โ โ โโโ find-similar-apis.ts # Similar API recommendations
โ โ โโโ wwdc/ # WWDC video tools
โ โ โโโ wwdc-handlers.ts # WWDC tool handlers
โ โ โโโ content-extractor.ts # Video content extraction
โ โ โโโ topics-extractor.ts # Topic listing
โ โ โโโ video-list-extractor.ts # Video list parsing
โ โโโ utils/ # Utility functions and helpers
โ โโโ cache.ts # Memory cache with TTL support
โ โโโ constants.ts # Application constants and URLs
โ โโโ error-handler.ts # Error handling and validation
โ โโโ http-client.ts # HTTP client with performance tracking
โ โโโ url-converter.ts # URL conversion utilities
โโโ ๐ฆ dist/ # Compiled JavaScript
โโโ ๐ package.json # Package configuration
โโโ ๐ README.md # This file
๐ Performance Features
- Memory-Based Caching: Custom cache implementation with automatic cleanup and TTL support
- Smart Search: Official Apple search API with enhanced result formatting
- Enhanced Analysis: Optional related APIs, platform compatibility, and similarity analysis
- Error Resilience: Graceful degradation with comprehensive error handling
- Type Safety: Full TypeScript with Zod v4.0.5 runtime validation
- Latest Dependencies: MCP SDK v1.15.1, optimized package footprint
๐พ Caching Strategy
Content Type | Cache Duration | Cache Size | Reason |
---|---|---|---|
API Documentation | 30 minutes | 500 entries | Frequently accessed, moderate updates |
Search Results | 10 minutes | 200 entries | Dynamic content, user-specific |
Framework Indexes | 1 hour | 100 entries | Stable structure, less frequent changes |
Technologies List | 2 hours | 50 entries | Rarely changes, large content |
Documentation Updates | 30 minutes | 100 entries | Regular updates, WWDC announcements |
๐งช Development
Quick Commands
# Development with auto-reload
pnpm run dev # or: npm run dev
# Build for production
pnpm run build # or: npm run build
# Type checking
pnpm exec tsc --noEmit # or: npx tsc --noEmit
# Clean build artifacts
pnpm run clean # or: npm run clean
Testing Locally
# Test the MCP server directly
node dist/index.js
# Test with sample queries
npx @kimsungwhee/apple-docs-mcp --test
๐ค Contributing
Contributions are welcome! Here's how to get started:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
๐ License
MIT License - see for details.
โ ๏ธ Disclaimer
This project is not affiliated with or endorsed by Apple Inc. It uses publicly available Apple Developer Documentation APIs for educational and development purposes.
Made with โค๏ธ for the Apple Developer Community
Search Apple Developer Documentation | iOS Development | macOS Development | Swift Programming | SwiftUI | UIKit | Xcode | WWDC Videos | Model Context Protocol | MCP Server