apple-docs

The Apple Docs MCP server provides access to Apple's official developer documentation via Model Context Protocol. It enables AI assistants and MCP-enabled clients to search across SwiftUI, UIKit, Foundation, Core Data, ARKit, Vision, and other Apple frameworks, returning API references, code examples in Swift and Objective-C, and WWDC-related resources. You can query for framework APIs, platform compatibility, and related APIs, and you’ll receive structured, context-aware results suitable for integration into Claude, Cursor, Windsurf, Zed, VS Code MCP, and other MCP-compatible tools. Typical use cases include retrieving SwiftUI API usage, finding UIKit classes or Core Data patterns, and exploring WWDC session references with code samples.

To start, connect the MCP server through your client (e.g., Claude Desktop, Cursor, VS Code MCP, Windsurf, or Zed) using the Apple Docs MCP server configuration. Once connected, send natural language requests like “Show me SwiftUI framework API index” or “Get documentation for URLSession async/await methods,” and the MCP server will return relevant documentation snippets, API references, and example code tailored to your query.

Prerequisites:

• Node.js and npm (or pnpm) installed on your machine
• Internet access to fetch the MCP package from npm

1. Global installation (recommended for universal access):

• Using npm:

npm install -g @kimsungwhee/apple-docs-mcp

• Using pnpm (alternative):

pnpm add -g @kimsungwhee/apple-docs-mcp

2. Direct usage with npx (no global install required):

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

3. Development setup (if you want to build from source):

git clone https://github.com/kimsungwhee/apple-docs-mcp.git
cd apple-docs-mcp

# Using npm
npm install
npm run build

4. Running via MCP client configurations:

• Example (npx):

# This is the configuration you would place in your MCP client
# to connect to the server
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

Notes and tips:

• The recommended startup method is using npx with the package name, which fetches and runs the MCP server on demand. You can force the latest release by appending @latest to the package name in your args (e.g., "@kimsungwhee/apple-docs-mcp@latest").
• Environment variables are not required for basic operation, but some MCP clients may support customizing server behavior via environment variables or client-side settings.
• On Windows, you may need to use a CMD wrapper or adjust the command/args in your MCP configuration (see README’s Windows example for reference).
• If the server is updated, ensure your MCP client reconnects to pick up new capabilities or fixes.
• You can access the same MCP server across multiple integrated tools (Claude Desktop, Cursor, VS Code, Windsurf, Zed, Cline, etc.) by adding the same apple-docs MCP server configuration in each client.