apple-docs-mcp — Claude MCP 必备工具中文教程

📦 Installation

<details> <summary><strong>📱 Claude Code</strong></summary>

claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest

📖 Claude Code MCP docs

</details>

<details> <summary><strong>🖱️ Cursor</strong></summary>

Via Settings: Settings → Cursor Settings → MCP → Add new global MCP server

Via Config File: Add to ~/.cursor/mcp.json:

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

📖 Cursor MCP docs

</details>

<details> <summary><strong>🔷 VS Code</strong></summary>

Add to your VS Code MCP config:

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

📖 VS Code MCP docs

</details>

<details> <summary><strong>🌊 Windsurf</strong></summary>

Add to your Windsurf MCP config:

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

📖 Windsurf MCP docs

</details>

<details> <summary><strong>⚡ Zed</strong></summary>

Add to your Zed settings.json:

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

📖 Zed Context Server docs

</details>

<details> <summary><strong>🔧 Cline</strong></summary>

Via Marketplace: 1. Open Cline → Menu (☰) → MCP Servers → Marketplace 2. Search "Apple Docs MCP" → Install

Via Config: Add to cline_mcp_settings.json:

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

</details>

<details> <summary><strong> Amazon A Developer CLI</strong></summary>

Via Config File: Add to ~/.aws/amazonq/mcp.json:

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

📖 Amazon A Developer CLI MCP docs

</details>

<details> <summary><strong>🪟 Windows</strong></summary>

For Windows systems, use:

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

</details>

<details> <summary><strong>⚙️ Advanced Installation</strong></summary>

Global Installation: ```bash

Build for production

pnpm run build # or: npm run build

Clean build artifacts

pnpm run clean # or: npm run clean ```

🚀 Quick Start

💬 Usage Examples

🛠️ Advanced Usage

"Find related APIs for @State with platform analysis"
"Resolve all references from SwiftUI documentation"
"Get platform compatibility analysis for Vision framework"
"Find similar APIs to UIViewController with deep search"

💻 Sample Code Library

"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get UIKit example projects"
"Show featured WWDC sample code"
"Find Core Data sample implementations"
"Show only beta sample code projects"

Test with sample queries

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

⚙️ Configuration

🔄 UserAgent Pool Configuration

The MCP server includes an intelligent UserAgent rotation system to improve API reliability:

Environment Variables

Custom Pool Configuration

```bash

Configure custom UserAgent pool

export USER_AGENT_POOL_CONFIG='[ {"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000}, {"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800} ]'

🔗 API Discovery

"Find APIs related to UIViewController"
"Show me similar APIs to withAnimation"
"Get all references from SwiftData documentation"
"Discover alternatives to Core Data NSManagedObject"