Apple Docs MCP

The npm package includes bundled WWDC video data (2014-2025), allowing for offline access and zero network latency for WWDC-related queries.

Included Data:

• 1,260+ WWDC session videos with full transcripts.
• 20 topic categories for organized browsing.
• 13 years of content (2012-2025).
• 35MB of optimized JSON data.

Note: To receive new WWDC content additions, you must update your package.

The server uses an intelligent LRU cache with optimized Time-To-Live (TTL) settings based on content type to balance performance and freshness:

To optimize performance and respect API limits, the server implements an in-memory cache with specific TTL (Time-To-Live) and capacity limits for different content types:

The Apple Docs MCP server is structured into several functional layers to provide access to Apple Developer Documentation:

• MCP Server Entry Point: src/index.ts contains all available tools.
• Tool Implementations: Located in src/tools/, these handle specific tasks like searching, fetching documentation, indexing frameworks, resolving references, and managing WWDC content.
• WWDC Tools: Specialized tools in src/tools/wwdc/ for extracting video content, topics, and video lists.
• Utilities: src/utils/ provides core services including memory caching (with TTL), error handling, an HTTP client with performance tracking, and a smart UserAgent rotation system.

The server uses Zod v4.0.5 for runtime validation and the MCP SDK v1.15.1.

The Apple Docs MCP server is structured into several functional layers:

• MCP Server Entrypoint: src/index.ts contains the main entry point and all available tools.
• Tools Implementation: Located in src/tools/, these handle specific tasks like searching, fetching documentation, indexing frameworks, finding related APIs, and managing WWDC video data.
• WWDC Subsystem: A specialized toolset in src/tools/wwdc/ for extracting video content, topics, and lists.
• Utilities: Found in src/utils/, providing core services like TTL-supported memory caching, HTTP client with performance tracking, a smart UserAgent rotation system, and URL conversion.
• Built-in WWDC Data: Unlike other tools, WWDC data (2014-2025) is bundled directly in the npm package, allowing for 100% offline access and zero network latency for these specific sessions.

Add the following configuration to your Windsurf MCP settings:

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

Add the following configuration to your VS Code MCP configuration file to enable the Apple Docs server via stdio:

{
  "mcp": {
    "servers": {
      "apple-docs": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
      }
    }
  }
}

Add the following configuration to your Zed settings.json file to register the Apple Docs context server:

{
  "context_servers": {
    "Apple Docs": {
      "command": {
        "path": "npx",
        "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
      },
      "settings": {}
    }
  }
}

When configuring MCP servers on Windows, you must use cmd with the /c flag to correctly execute npx via the command prompt:

{
  "mcpServers": {
    "apple-docs": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Windows users, use the cmd /c prefix to ensure npx executes correctly within the MCP configuration:

{
  "mcpServers": {
    "apple-docs": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

You can verify the server's functionality using the following methods:

Run the compiled server directly:

node dist/index.js

Run a test query using the CLI:

npx @kimsungwhee/apple-docs-mcp --test

Use the following commands to manage the development lifecycle of the Apple Docs MCP project:

Development Mode (with auto-reload):

pnpm run dev
# or
npm run dev

Production Build:

pnpm run build
# or
npm run build

Type Checking:

pnpm exec tsc --noEmit
# or
npx tsc --noEmit

Clean Build Artifacts:

pnpm run clean
# or
npm run clean