Apple Doc MCP

🚀 Apple Doc MCP

A Model Context Protocol (MCP) server that offers seamless access to Apple's Developer Documentation directly within your AI coding assistant. This server simplifies the process of retrieving Apple's official documentation, enhancing your coding efficiency.

🚀 Quick Start

Prerequisites

• Node.js 18+ installed on your system
• npm (comes with Node.js)

Step 1: Clone and Build

1. Clone this repository:

   git clone https://github.com/MightyDillah/apple-doc-mcp.git
   cd apple-doc-mcp
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

   This compiles the TypeScript code and creates the dist/ folder with the executable server.

Step 2: 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

{
  "mcpServers": {
    "apple-doc-mcp": {
      "command": "node",
      "args": ["/path/to/apple-doc-mcp/dist/index.js"]
    }
  }
}

⚠️ Important Note

Replace /path/to/apple-doc-mcp with the actual path to your cloned repository.

💡 Usage Tip

To get the absolute path on macOS/Linux, run pwd inside the apple-doc-mcp folder.

Step 3: Restart & Test

1. Restart your AI assistant
2. Try: "List available Apple technologies"
3. You should see 4 new tools available
4. The server will automatically notify you if updates are available on startup

✨ 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

Prerequisites

• Node.js 18+ installed on your system
• npm (comes with Node.js)

Step 1: Clone and Build

1. Clone this repository:

   git clone https://github.com/MightyDillah/apple-doc-mcp.git
   cd apple-doc-mcp
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

   This compiles the TypeScript code and creates the dist/ folder with the executable server.

Step 2: 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

{
  "mcpServers": {
    "apple-doc-mcp": {
      "command": "node",
      "args": ["/path/to/apple-doc-mcp/dist/index.js"]
    }
  }
}

Step 3: Restart & Test

1. Restart your AI assistant
2. Try: "List available Apple technologies"
3. You should see 4 new tools available
4. The server will automatically notify you if updates are available on startup

💻 Usage Examples

Basic Usage

Once configured, just talk naturally to your AI assistant. Here are some examples:

Browse Available Technologies

"Use apple-doc-mcp to list all current Apple frameworks"
"Get the latest available Apple technologies from Apple's docs"
"Search Apple documentation for all available frameworks"

Explore a Framework

"Use apple-doc-mcp to browse SwiftUI framework structure"
"Get current UIKit topics from Apple documentation"
"Search Apple docs for Foundation framework details"

Search for Specific APIs

"Search Apple's SwiftUI docs for drag and drop APIs"
"Use apple-doc-mcp to find RPBroadcast* classes in ReplayKit"
"Look up current *View* symbols across Apple frameworks"
"Find all *Controller classes in UIKit using Apple docs"

Get Detailed Documentation

"Get the latest SwiftUI View protocol docs from Apple"
"Use apple-doc-mcp to look up UIViewController documentation"
"Search Apple's current docs for NSURLSession details"

The AI will automatically use the MCP tools to fetch current Apple documentation and provide comprehensive answers.

Advanced Usage

You can also use the available tools directly with specific parameters.

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:

{"path": "SwiftUI"}
{"path": "documentation/SwiftUI/View"}
{"path": "Foundation"}

search_symbols

Search for symbols across Apple frameworks with advanced filtering.

• query (required): Search query with wildcard support
• framework (optional): Search within specific framework
• symbolType (optional): Filter by symbol type (class, protocol, struct, etc.)
• platform (optional): Filter by platform (iOS, macOS, etc.)
• maxResults (optional): Maximum results (default: 20)

Examples:

{"query": "RPBroadcast*"}
{"query": "*Controller", "framework": "UIKit"}
{"query": "*View*", "platform": "iOS", "maxResults": 5}

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

🤝 Contributing

Found a bug or want to add a feature? Contributions welcome!

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

📄 License

The license information is not provided in the original README. If you have the license details, please let me know, and I'll add it to the document.

📋 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 frameworks
  • get_documentation - Get symbol or framework docs (handles both automatically)
  • search_symbols - Search with wildcards and filters
  • check_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