# Cupertino — Offline Apple Docs MCP Server

> Cupertino crawls and serves Apple docs to agents via MCP; verified 736★ and ships a bundle with 277k+ pages across 402 frameworks.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
brew tap mihaelamj/tap
brew install cupertino && cupertino setup
cupertino serve
```

## Intro

Cupertino crawls and serves Apple docs to agents via MCP; verified 736★ and ships a bundle with 277k+ pages across 402 frameworks.

**Best for:** iOS/macOS teams who want deterministic, offline Apple API answers instead of web search hallucinations

**Works with:** Claude Desktop/Claude Code/Codex/Cursor and any MCP client that can run `cupertino serve`

**Setup time:** 5-12 minutes (bundle) / 45+ minutes (build)

### Key facts (verified)

- GitHub: 735 stars · 28 forks · pushed 2026-05-14.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `cupertino serve`.

## Main

- Prefer the prebuilt bundle first: get a stable offline index, then decide if you need re-crawl/build for custom sources.

- Wire it as a shared team tool: add to your MCP client config so every agent session can query docs deterministically.

- Reduce token waste: search locally and cite canonical doc URLs instead of copying long pages into model context.

### Source-backed notes

- README claims an offline bundle with 277,000+ pages across 402 frameworks (v1.0.2 bundle) and SQLite FTS5 search.
- README provides an instant setup path: `cupertino setup` then `cupertino serve`.
- README includes one-command wiring for Claude Code (`claude mcp add cupertino --scope user -- $(which cupertino)`).

### FAQ

- **Do I need internet after setup?**: For offline search, no — once the bundle is downloaded, the index is local.
- **Can I use it with Codex/Cursor?**: Yes — README includes config snippets for Codex TOML and Cursor `.cursor/mcp.json`.
- **Should I build the database myself?**: Only if you need custom sources; README notes remote build can take ~45 minutes.

## Source & Thanks

> Source: https://github.com/mihaelamj/cupertino
> License: MIT
> GitHub stars: 735 · forks: 28

---

<!-- ZH -->

## Quick Use

```bash
brew tap mihaelamj/tap
brew install cupertino && cupertino setup
cupertino serve
```

## Intro

Cupertino 可抓取并通过 MCP 向 agent 提供离线 Apple 开发者文档；已验证 736★，预构建 bundle 含 277k+ 页面、402 frameworks，并用 SQLite FTS5 搜索。

**Best for:** iOS/macOS 团队：想要确定性的离线 Apple API 查询结果，减少搜索与幻觉

**Works with:** Claude Desktop/Claude Code/Codex/Cursor 等可运行 `cupertino serve` 的 MCP 客户端

**Setup time:** 5-12 minutes (bundle) / 45+ minutes (build)

### Key facts (verified)

- GitHub：735 stars · 28 forks；最近更新 2026-05-14。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`cupertino serve`。

## Main

- 优先使用预构建 bundle：先获得稳定的离线索引，再决定是否需要为自定义来源重新抓取/构建。

- 把它当作团队基础设施：加入 MCP 配置，让每次 agent session 都能稳定查文档。

- 减少 token 浪费：本地搜索并引用权威文档链接，而不是把长网页整段塞进模型上下文。

### Source-backed notes

- README 宣称 v1.0.2 bundle 含 277,000+ 页面与 402 个 frameworks，并使用 SQLite FTS5 搜索索引。
- README 给出最简路径：`cupertino setup` 后 `cupertino serve`。
- README 提供 Claude Code 一键接入示例：`claude mcp add cupertino --scope user -- $(which cupertino)`。

### FAQ

- **安装后还需要联网吗？**：离线搜索不需要——bundle 下载完成后索引在本地。
- **Codex/Cursor 能用吗？**：可以。README 给出 Codex TOML 与 Cursor `.cursor/mcp.json` 配置示例。
- **要不要自己构建数据库？**：只有在需要自定义来源时才需要；README 提到 remote build 可能要 ~45 分钟。

## Source & Thanks

> Source: https://github.com/mihaelamj/cupertino
> License: MIT
> GitHub stars: 735 · forks: 28


---
Source: https://tokrepo.com/en/workflows/cupertino-offline-apple-docs-mcp-server
Author: MCP Hub