Provides access to Apple's Developer Documentation, allowing users to browse frameworks, search for symbols, and retrieve detailed documentation on Apple technologies like SwiftUI, UIKit, and Foundation.
Enables checking for repository updates via Git and provides update notifications when new versions are available.
Enables filtering and searching for iOS-specific documentation within Apple's developer resources.
Allows filtering and searching for macOS-specific documentation within Apple's developer resources.
Provides access to Swift-related documentation and frameworks from Apple's developer resources.
Apple Doc MCP
A Model Context Protocol (MCP) server that provides seamless access to Apple's Developer Documentation directly within your AI coding assistant.
📋 Changelog
1.0.1 Update
- 🎯 Intelligent Fallback System: When searching for frameworks instead of symbols (e.g., "SwiftUI"), the server now provides helpful framework information and guidance on correct usage
- 🔧 Tool Consolidation: Streamlined from 4 tools to 4 focused tools:
list_technologies
- Browse all Apple frameworksget_documentation
- Get symbol or framework docs (handles both automatically)search_symbols
- Search with wildcards and filterscheck_updates
- Check for repository updates via git
- 🚀 Pre-built Distribution: No more manual building required - clone and use immediately
- 🧹 Dynamic Framework Discovery: Removed all hard-coded framework lists for fully dynamic operation
- ⚡ Automatic Update Notifications: Server automatically checks for updates on startup and notifies users when new versions are available
- 🛡️ Enhanced Error Handling: Better null safety and professional error messages
🚀 Features
- 🔍 Smart Search: Find symbols across all Apple frameworks with wildcard support (
*
,?
) - 📚 Framework Browsing: Explore any Apple framework structure (SwiftUI, UIKit, Foundation, etc.)
- 📖 Detailed Documentation: Get comprehensive symbol documentation with examples
- 🎯 Advanced Filtering: Filter by platform (iOS, macOS, etc.), symbol type, or framework
- ⚡ Real-time Data: Always up-to-date with Apple's latest documentation
- 🔄 Auto-Update Alerts: Automatic notifications when repository updates are available
- 🧠 AI-Optimized: Clean markdown output perfect for AI assistants
📦 Installation
- Clone this repository:
- Ready to use! (Pre-built distribution included)
🔌 Quick Setup
Step 1: Configure Your AI Assistant
Claude Desktop: Edit ~/.config/claude/claude_desktop_config.json
Cursor: Settings (Cmd/Ctrl + ,
) → Extensions → MCP
Continue.dev: Edit ~/.continue/config.json
VS Code (Claude): Settings → MCP Servers
Replace /path/to/apple-doc-mcp
with the actual path to your cloned repository.
Step 2: Restart & Test
- Restart your AI assistant
- Try: "List available Apple technologies"
- You should see 4 new tools available
- The server will automatically notify you if updates are available on startup
🎯 How to Use
Once configured, just talk naturally to your AI assistant. Here are examples:
Browse Available Technologies
Explore a Framework
Search for Specific APIs
Get Detailed Documentation
The AI will automatically use the MCP tools to fetch current Apple documentation and provide comprehensive answers.
🛠️ Available Tools
list_technologies
Browse all available Apple frameworks and technologies.
get_documentation
Get detailed documentation for symbols or frameworks (automatically detects type).
path
(required): Documentation path (e.g., "documentation/SwiftUI/View") or framework name (e.g., "SwiftUI")
Examples:
search_symbols
Search for symbols across Apple frameworks with advanced filtering.
query
(required): Search query with wildcard supportframework
(optional): Search within specific frameworksymbolType
(optional): Filter by symbol type (class, protocol, struct, etc.)platform
(optional): Filter by platform (iOS, macOS, etc.)maxResults
(optional): Maximum results (default: 20)
Examples:
check_updates
Check for available updates from the git repository.
- No parameters required
- Shows current branch status, available updates, and update instructions
- Note: The server automatically checks for updates on startup and displays notifications
🚨 Troubleshooting
Server Won't Start
- Ensure Node.js 18+ is installed
- Verify the path in your MCP config points to the correct
dist/index.js
location - Check your MCP configuration syntax
- Restart your AI assistant after config changes
"0 tools" Showing Up
- This usually means the server isn't starting properly
- Check the file path in your configuration is correct and absolute
- The
dist
directory is included - no build step required - Try testing the server directly:
node /path/to/apple-doc-mcp/dist/index.js
No Results Found
- Try broader search terms
- Use wildcard patterns:
"*View*"
instead of"View"
- Remove filters to expand search scope
Performance Issues
- First search may be slower (builds cache)
- Subsequent searches are much faster
- Reduce
maxResults
for faster responses
⚙️ Technical Details
- 10-minute caching to avoid API rate limits
- 15-second timeouts for reliable performance
- Smart framework prioritization for faster searches
- Graceful error handling for robust operation
📋 Requirements
- Node.js: 18.0.0 or higher
- Memory: ~50MB RAM during operation
- Network: Internet connection to Apple's documentation API
🤝 Contributing
Found a bug or want to add a feature? Contributions welcome!
- Fork the repository
- Create a feature branch
- Submit a pull request
See CONTRIBUTING.md for detailed guidelines.
A Model Context Protocol server that provides AI coding assistants with direct access to Apple's Developer Documentation, enabling seamless lookup of frameworks, symbols, and detailed API references.
- 📋 Changelog
- 🚀 Features
- 📦 Installation
- 🔌 Quick Setup
- 🎯 How to Use
- 🛠️ Available Tools
- 🚨 Troubleshooting
- ⚙️ Technical Details
- 📋 Requirements
- 🤝 Contributing
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to build and test Xcode projects directly through a standardized interface, with capabilities for running tests, monitoring progress, and accessing logs in real-time.Last updated -29TypeScript
Appwrite MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.Last updated -8440PythonMIT License- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for Xcode-related operations, making it easier to work with iOS project management, building, testing, archiving, and deploying apps to both simulators and physical devices.Last updated -943JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.Last updated -Python