🍎📚 Cupertino

Apple Documentation Crawler & MCP Server

A Swift-based tool to crawl, index, and serve Apple’s developer documentation to AI agents via the Model Context Protocol (MCP).

What is Cupertino?

Cupertino is a local, structured, AI-ready documentation system for Apple platforms. It:

• Crawls Apple Developer documentation, Swift.org, Swift Evolution proposals, and Swift package metadata
• Indexes everything into a fast, searchable SQLite FTS5 database with BM25 ranking
• Serves documentation to AI agents like Claude via the Model Context Protocol
• Provides offline access to 22,000+ documentation pages across 261 frameworks

Why Build This?

• No more hallucinations: AI agents get accurate, up-to-date Apple API documentation
• Offline development: Work with full documentation without internet access
• Deterministic search: Same query always returns same results
• Local control: Own your documentation, inspect the database, script workflows
• AI-first design: Built specifically for AI agent integration via MCP

Quick Start

Note: All commands must be run from the Packages directory (cupertino/Packages/).

Requirements

• macOS 15+ (Sequoia)
• Swift 6.2+
• Xcode 16.0+
• ~2-3 GB disk space for full documentation

Installation

git clone https://github.com/mihaelamj/cupertino.git
cd cupertino

# Using Makefile (recommended)
make build                       # Build release binary
sudo make install                # Install to /usr/local/bin

# Or using Swift Package Manager directly
cd Packages
swift build -c release
sudo ln -sf "$(pwd)/.build/release/cupertino" /usr/local/bin/cupertino

Download Documentation

# Download Apple documentation (~20-24 hours for 13,000+ pages)
# Takes time due to 0.5s default delay between requests to respect Apple's servers
cupertino fetch --type docs --max-pages 15000

# Download Swift Evolution proposals (~2-5 minutes)
cupertino fetch --type evolution

# Build search index (~2-5 minutes)
cupertino save

Use with Claude Desktop

1. Configure Claude Desktop - Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cupertino": {
      "command": "/usr/local/bin/cupertino"
    }
  }
}

Note: The cupertino command defaults to cupertino serve when run without arguments.

2. Restart Claude Desktop

3. Ask Claude about Apple APIs:

   • “Search for SwiftUI documentation”
   • “What does Swift Evolution proposal SE-0001 propose?”
   • “List available frameworks”

What You Get

Once configured, Claude Desktop can search your local documentation:

Search Results Example: