apple-docs-mcp

环境要求

• 支持 MCP 的 AI 客户端（Claude Code、Cursor、VS Code、Windsurf、Zed、Cline 等）之一
• 本机已安装 Node.js 与 npx（README 所有安装方式均通过 npx 拉起）
• Windows 系统需要使用 cmd /c npx 形式配置

安装与启动步骤

1. 1Claude Code 一键安装

   在终端执行该命令，向 Claude Code 注册名为 apple-docs 的 MCP 服务器，无需手动编辑配置文件。

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

   复制

2. 2Cursor 写入配置

   打开 ~/.cursor/mcp.json（或通过 Settings → Cursor Settings → MCP → Add new global MCP server），加入 apple-docs 服务器配置。

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

   复制

3. 3VS Code 写入配置

   在 VS Code 的 MCP 配置中加入 mcp.servers，注意需声明 "type": "stdio"。

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

   复制

4. 4Zed 写入配置

   在 Zed 的 settings.json 中使用 context_servers 字段配置，路径与参数写在 command 对象里。

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

   复制

5. 5Windsurf 写入配置

   在 Windsurf 的 MCP 配置中使用与 Cursor 相同的 mcpServers 结构填写。

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

   复制

6. 6Cline 写入配置

   可在 Cline 菜单 ☰ → MCP Servers → Marketplace 搜索 Apple Docs MCP 安装，或把配置写进 cline_mcp_settings.json。

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

   复制

7. 7Windows 专用配置

   Windows 下 npx 需要包裹在 cmd /c 中执行，其余平台可沿用上面的配置。

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

   复制

关键配置

如何确认成功

在客户端的 MCP 服务器列表中看到 apple-docs 且状态正常，对话中能触发 Apple 文档搜索等工具返回结果即成功。

常见问题

注意事项

• 所有命令均来自 README，未提到的端口、环境变量请勿自行添加。
• 各客户端的配置文件位置不同（如 Cursor 为 ~/.cursor/mcp.json），请按 README 对应条目放置。
• 版本标签可用 @latest 获取最新版，也可按需固定版本号。