Appledeepdoc MCP

🚀 Apple Deep Docs MCP

Access hidden Xcode documentation and Apple developer resources through the Model Context Protocol.

🚀 Quick Start

The Apple Deep Docs MCP allows users to access a wealth of Apple's development documentation through the Model Context Protocol. It provides access to hidden Xcode documentation, Apple Developer API, Swift Evolution Proposals, Swift Open - Source Repositories, and WWDC Session Notes.

✨ Features

• Hidden Xcode Documentation: Searches the AdditionalDocumentation folder inside Xcode.app, which includes advanced SwiftUI patterns, Liquid Glass design guides for iOS 26+, and framework - specific implementation details not available on Apple's public developer site.
• Apple Developer API: Fetches and parses structured documentation from developer.apple.com.
• Swift Evolution Proposals: Searches over 500 proposals to understand the rationale behind language features.
• Swift Open Source Repositories: Searches across all Apple/SwiftLang GitHub repositories for implementation examples.
• WWDC Session Notes: Accesses community - curated WWDC session summaries for performance optimization and architecture patterns.

📦 Installation

Prerequisites

• Python 3.10+
• Xcode installed (for local documentation features)

Steps

1. Clone this repository:

git clone https://github.com/yourusername/appledeepdocs-mcp.git
cd appledeepdocs-mcp

2. Set up the Python environment:

# Create virtual environment
python3 -m venv venv

# Install dependencies
./venv/bin/pip install fastmcp

📚 Documentation

Configuration

Add the following to your Claude Desktop config file:

{
  "mcpServers": {
    "apple-deep-docs": {
      "command": "/path/to/appledeepdocs-mcp/run.sh"
    }
  }
}

Replace /path/to/appledeepdocs-mcp with the full path where you cloned this repository. The run.sh script automatically handles the virtual environment.

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

After updating the config, restart Claude Desktop to load the MCP server.

Project Structure

├── main.py               # Entry point for the MCP server
├── config.py            # Configuration and Xcode path discovery
├── tools.py             # MCP tool definitions and input validation
├── docs/                # Documentation access modules
│   ├── local_docs.py    # Xcode's hidden local documentation
│   └── apple_docs.py    # Apple Developer website API access
├── evolution/           # Swift language evolution
│   └── swift_evolution.py
├── repos/               # GitHub repository searching
│   └── swift_repos.py
├── suggestions/         # Intelligent suggestion system
│   └── suggestions.py   # Centralized suggestion engine
├── wwdc/                # WWDC session resources
│   └── wwdc_notes.py
└── pyproject.toml       # Package configuration

Available Tools

Local Documentation

• search_docs - Search Xcode's hidden documentation
• get_document - Retrieve full content of a specific document
• list_documents - List all available documentation files
• get_xcode_versions - Get installed Xcode versions with documentation

Apple Developer Resources

• fetch_apple_documentation - Fetch structured docs from developer.apple.com
• search_apple_online - Search both local and online Apple documentation
• get_framework_info - Get direct documentation URL for any framework

Swift Evolution

• search_swift_evolution - Search Swift Evolution proposals
• get_swift_evolution_proposal - Get details of a specific proposal

GitHub Resources

• search_swift_repos - Search across all Apple/SwiftLang repositories
• fetch_github_file - Fetch source code from GitHub repositories

WWDC Resources

• search_wwdc_notes - Search WWDC session notes and transcripts
• get_wwdc_session - Get WWDC session URLs from session ID

Environment Variables

• XCODE_DOC_PATH: Override default Xcode documentation search path

📄 License

This project is licensed under the MIT license.