apple-docs

# Apple Developer Documentation

Provides on-demand access to Apple Developer Documentation via the apple-docs-mcp server. Triggers when users ask about SwiftUI, UIKit, iOS, macOS, watchOS, tvOS, visionOS, Swift, Xcode, WWDC, Apple APIs, or Apple frameworks.

## Invocation

Use the wrapper script to call MCP tools:

```bash
$PLUGIN_DIR/scripts/apple-docs.sh <tool_name> '<json_arguments>'
```

The script starts the MCP server, sends a JSON-RPC request, returns the response, and terminates. Each call is independent.

## Tool Selection Strategy

### Prefer WWDC Tools for Speed (Bundled Offline)

WWDC content (2014-2025, 1,266 videos) is bundled in the npm package. These tools are fast and work offline:

- `list_wwdc_years` - Get available years and video counts
- `browse_wwdc_topics` - List topic categories (19 topics)
- `list_wwdc_videos` - Browse sessions by year/topic
- `search_wwdc_content` - Full-text search transcripts and code
- `get_wwdc_video` - Get full transcript and code examples
- `get_wwdc_code_examples` - Browse code from sessions
- `find_related_wwdc_videos` - Discover related sessions

### Live Documentation Tools (Network Required)

These query Apple's servers:

- `search_apple_docs` - Search documentation
- `get_apple_doc_content` - Get full doc content
- `list_technologies` - Browse frameworks
- `search_framework_symbols` - Find APIs in a framework
- `get_related_apis` - API relationships
- `find_similar_apis` - Alternative APIs
- `get_platform_compatibility` - Platform/version support
- `get_sample_code` - Sample projects
- `get_documentation_updates` - Latest updates
- `get_technology_overviews` - Comprehensive guides

## Common Patterns

### Search Documentation

```bash
$PLUGIN_DIR/scripts/apple-docs.sh search_apple_docs '{"query":"SwiftUI List","type":"documentation"}'
```

Arguments:
- `query` (required): Search terms
- `type`: "all", "documentation", or "sample"

### Get Document Content

```bash
$PLUGIN_DIR/scripts/apple-docs.sh get_apple_do