Apple Dev MCP Server 🍎

A Model Context Protocol (MCP) server for Apple development assistance. Provides tools for fetching live Apple documentation directly from developer.apple.com, analyzing Xcode build errors, and checking Swift Evolution proposal status.

✨ Features

• 🔴 Live Documentation - Fetches real-time documentation from Apple's official API
• 🔧 Xcode Error Analysis - Intelligent parsing and fix suggestions for build errors
• 📋 Swift Evolution Tracking - Check proposal status for Swift language features

🔧 Tools

📦 Installation

Via npm (Recommended)

npm install -g apple-dev-mcp-server

Via npx (No install required)

npx apple-dev-mcp-server

From Source

git clone https://github.com/erdncyz/apple-dev-mcp-server.git
cd apple-dev-mcp-server
npm install
npm run build

Configuration

For Claude Desktop

Add to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-dev": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/Desktop/apple-dev-mcp-server/dist/index.js"]
    }
  }
}

For VS Code with GitHub Copilot

Add to your VS Code settings (.vscode/settings.json or user settings):

{
  "github.copilot.chat.mcpServers": {
    "apple-dev": {
      "command": "node",
      "args": ["${userHome}/Desktop/apple-dev-mcp-server/dist/index.js"]
    }
  }
}

For Other MCP Clients

The server uses stdio transport and can be integrated with any MCP-compatible client:

node /path/to/apple-dev-mcp-server/dist/index.js

Usage Examples

Fetch Apple Documentation

Use the fetch_latest_apple_docs tool to get documentation for NavigationStack

Analyze Build Errors

Use xcode_diagnostic_analyzer to analyze this error:
"cannot find type 'NavigationStack' in scope"

Check Swift Evolution

Use swift_evolution_check to verify if 'nonisolated(unsafe)' is available in Swift 5.10

🔴 Live Documentation API

This MCP server uses Apple's undocumented JSON API to fetch real-time documentation:

https://developer.apple.com/tutorials/data/documentation/{framework}/{symbol}.json

Supported Frameworks

SwiftUI, UIKit, Foundation, Observation, SwiftData, Combine, RealityKit, ARKit, CoreData, CoreML, MapKit, CloudKit, HealthKit, StoreKit, AVFoundation, and more.

Example Response

# 📚 Apple Developer Documentation: NavigationStack

> ✅ Live documentation from developer.apple.com

**Type:** Structure
**Framework:** SwiftUI
**Availability:** iOS 16.0+, iPadOS 16.0+, macOS 13.0+, tvOS 16.0+, visionOS 1.0+, watchOS 9.0+

## Declaration
@MainActor struct NavigationStack<Data, Root> where Root : View

## Overview
A view that displays a root view and enables you to present additional views...

Development

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server
npm start

Project Structure

apple-dev-mcp-server/
├── src/
│   ├── index.ts                 # Main MCP server entry point
│   └── tools/
│       ├── fetch-apple-docs.ts  # Live documentation fetcher
│       ├── xcode-diagnostic-analyzer.ts  # Build error analyzer
│       └── swift-evolution-check.ts      # Swift Evolution checker
├── dist/                        # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Requirements

• Node.js >= 18.0.0
• npm or yarn

📄 License

MIT

🔗 Links

• npm Package
• GitHub Repository
• Apple Developer Documentation

Note: This is a community tool and is not affiliated with or endorsed by Apple Inc.