@kimsungwhee/apple-docs-mcp
Advanced tools
MCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistants
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.
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
@latestto force the latest version:"args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"]
Restart Claude Desktop and start asking about Apple APIs!
claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest
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"]
}
}
}
Add to your VS Code MCP config:
{
"mcp": {
"servers": {
"apple-docs": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
}
Add to your Windsurf MCP config:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
Add to your Zed settings.json:
{
"context_servers": {
"Apple Docs": {
"command": {
"path": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
},
"settings": {}
}
}
}
Via Marketplace:
Via Config: Add to cline_mcp_settings.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
For Windows systems, use:
{
"mcpServers": {
"apple-docs": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
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
"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"
"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"
"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"
"Find APIs related to UIViewController"
"Show me similar APIs to withAnimation"
"Get all references from SwiftData documentation"
"Discover alternatives to Core Data NSManagedObject"
"List all Beta frameworks in iOS 26"
"Show me Graphics & Games technologies"
"What machine learning frameworks are available?"
"Analyze platform compatibility for Vision framework"
"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"
"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"
"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"
"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"
"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"
"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"
"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"
| 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 |
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
│ ├── user-agent-pool.ts # Smart UserAgent rotation system
│ ├── http-headers-generator.ts # Dynamic browser headers generation
│ └── url-converter.ts # URL conversion utilities
├── 📦 dist/ # Compiled JavaScript
├── 📄 package.json # Package configuration
└── 📖 README.md # This file
| 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 |
All WWDC video data (2014-2025) is bundled directly in the npm package, providing:
The package includes:
Note: Keep your package updated to get the latest WWDC content additions.
The MCP server includes an intelligent UserAgent rotation system to improve API reliability:
| Variable | Description | Default | Example |
|---|---|---|---|
USER_AGENT_ROTATION_ENABLED | Enable/disable rotation | true | true |
USER_AGENT_POOL_STRATEGY | Rotation strategy | random | smart |
USER_AGENT_MAX_RETRIES | Max retry attempts | 3 | 5 |
USER_AGENT_POOL_CONFIG | Custom pool config (JSON) | Built-in agents | See below |
# Configure custom UserAgent pool
export USER_AGENT_POOL_CONFIG='[
{"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000},
{"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800}
]'
# Set rotation strategy (random/sequential/smart)
export USER_AGENT_POOL_STRATEGY=smart
# Enable debugging
export NODE_ENV=development
random: Fast random selection (best performance)sequential: Round-robin rotation (predictable order)smart: Success rate optimization (best reliability)The server includes 12+ pre-configured UserAgent strings covering:
# 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
# Test the MCP server directly
node dist/index.js
# Test with sample queries
npx @kimsungwhee/apple-docs-mcp --test
Contributions are welcome! Here's how to get started:
git checkout -b feature/amazing-featuregit commit -m 'Add amazing feature'git push origin feature/amazing-featureMIT License - see LICENSE for details.
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
FAQs
MCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistants
The npm package @kimsungwhee/apple-docs-mcp receives a total of 2,297 weekly downloads. As such, @kimsungwhee/apple-docs-mcp popularity was classified as popular.
We found that @kimsungwhee/apple-docs-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Malicious Namastex.ai npm packages appear to replicate TeamPCP-style Canister Worm tradecraft, including exfiltration and self-propagation.
Product
Explore exportable charts for vulnerabilities, dependencies, and usage with Reports, Socket’s new extensible reporting framework.
Product
Socket for Jira lets teams turn alerts into Jira tickets with manual creation, automated ticketing rules, and two-way sync.