Apple Docs MCP
kennywillbe/apple-docs-mcp
Acesso estruturado à documentação Apple Developer via MCP para IDEs
Ver no GitHubServidor MCP que fornece acesso local à documentação oficial do Apple Developer, permitindo buscas diretas em frameworks, APIs e tecnologias Apple sem depender de web search genérico. Integra-se com Claude, Cursor, Windsurf e outras ferramentas via protocolo MCP.
Instalação
npx convez-ai kennywillbe/apple-docs-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento iOS/macOS com acesso direto a frameworks como SwiftUI e AppKit
- Busca de APIs e símbolos específicos em documentação oficial Apple
- Integração com editores e IDEs (Claude Desktop, Cursor, Windsurf) para context durante coding
Veredito

Ferramenta sólida para devs Apple que precisam de documentação confiável dentro de seus fluxos de IA. A arquitetura local com cache evita latência e garante acesso offline, mas o escopo limita-se ao ecossistema Apple.
README
A tradução para o português deste README ainda está na fila.
Apple Docs MCP
MCP server for Apple Developer Documentation. It uses Apple Developer search and Apple's official documentation Markdown/JSON endpoints, so clients can read Apple docs without falling back to general web search.
Install
codex mcp add apple_docs -- npx -y github:kennywillbe/apple-docs-mcp
Restart Codex, then run /mcp and check that apple_docs is enabled.
To reinstall:
codex mcp remove apple_docs
codex mcp add apple_docs -- npx -y github:kennywillbe/apple-docs-mcp
MCP Command
Use this command anywhere a client asks for a stdio MCP command:
npx -y github:kennywillbe/apple-docs-mcp
Client Config
Claude Code
claude mcp add --transport stdio apple_docs -- npx -y github:kennywillbe/apple-docs-mcp
claude mcp list
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"apple_docs": {
"command": "npx",
"args": ["-y", "github:kennywillbe/apple-docs-mcp"]
}
}
}
Restart Claude Desktop after saving.
Cursor
Use ~/.cursor/mcp.json for global config or .cursor/mcp.json for a single
project:
{
"mcpServers": {
"apple_docs": {
"command": "npx",
"args": ["-y", "github:kennywillbe/apple-docs-mcp"]
}
}
}
Windsurf
Add this server to mcp_config.json:
{
"mcpServers": {
"apple_docs": {
"command": "npx",
"args": ["-y", "github:kennywillbe/apple-docs-mcp"]
}
}
}
VS Code / GitHub Copilot
VS Code uses servers instead of mcpServers:
{
"servers": {
"apple_docs": {
"type": "stdio",
"command": "npx",
"args": ["-y", "github:kennywillbe/apple-docs-mcp"]
}
}
}
Tools
search_apple_docs: Search Apple Developer results.list_apple_technologies: Find Apple documentation technologies/frameworks.choose_apple_technology: Select a technology for follow-up symbol tools.current_apple_technology: Show the selected technology.search_apple_symbols: Search symbols/articles inside a selected technology.get_apple_symbol_documentation: Resolve a symbol inside a technology and fetch its docs.get_apple_doc_content: Fetch documentation as Markdown or JSON.get_apple_doc_metadata: Fetch parsed metadata and section counts.list_apple_doc_related: List topic, see-also, and relationship links.list_apple_doc_headings: List Markdown headings.resolve_apple_doc_url: Resolve canonical and Apple data URLs.apple_docs_cache_status: Show cache status.clear_apple_docs_cache: Clear cached responses.
Typical Flow
For API work, avoid broad web-style search first:
list_apple_technologieswith a query likeintentorwidget.choose_apple_technologywithApp Intents,SwiftUI,WidgetKit, etc.search_apple_symbolswith a symbol or keyword likeAppIntent.get_apple_symbol_documentationwithAppIntentorAppIntent/perform().
Use search_apple_docs when you need broad Apple Developer results across
documentation, videos, sample code, or WWDC content.
Local Development
git clone https://github.com/kennywillbe/apple-docs-mcp.git
cd apple-docs-mcp
npm install
npm run build
npm run typecheck
Run locally with Codex:
codex mcp add apple_docs -- node "$PWD/dist/index.js"
Use the inspector:
npm run inspect
Environment
APPLE_DOCS_MCP_CACHE_DIR: Override cache directory.APPLE_DOCS_MCP_CACHE_TTL_SECONDS: Override cache TTL. Default:86400.APPLE_DOCS_MCP_USER_AGENT: Override User-Agent header.APPLE_DOCS_MCP_SYMBOL_SEARCH_CHILD_PAGES: Child collection pages to inspect for normal symbol search. Default:40.APPLE_DOCS_MCP_SYMBOL_SEARCH_DEEP_CHILD_PAGES: Child collection pages to inspect whendeepis enabled. Default:120.
Notes
This server fetches pages on demand. Do not bulk crawl Apple documentation.
The search tool depends on the Apple Developer search endpoint used by Apple's
own search page. If that endpoint is unavailable, search_apple_docs falls
back to official documentation indexes for documentation queries. Direct
Markdown/JSON documentation fetches are separate from that search endpoint.
search_apple_symbols and get_apple_symbol_documentation support deep and
max_child_pages for cases where a framework spreads symbols across many child
documentation pages. Keep the default search for normal use, and enable deep
search only when a known symbol is missing.