Skip to content
Back to search

apple-doc-mcp

MCP server providing seamless access to Apple Developer Documentation with smart search and wildcard support

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mightydillah--apple-doc-mcp/badge.svg)](/listings/mightydillah--apple-doc-mcp)

HTML

<a href="/listings/mightydillah--apple-doc-mcp"><img src="/api/listings/mightydillah--apple-doc-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 98 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Apple Doc MCP
  2. A Model Context Protocol (MCP) server that provides seamless access to Apple's Developer Documentation directly within your AI coding assistant.
  3. **Note:** Hey guys, thanks for checking out this MCP! Since I've been working on it on a regular basis, and as such its getting really expensive to build it and improve it to work on different platforms, all while adding new features (tokens aint cheap ya'll).
  4. if you find this MCP helpful, I'd really apperciate it if you clicked on the [❤️ Sponsor](https://github.com/sponsors/MightyDillah) button up there, any contribution is apperciated! thanks.
  5. ## 📋 Changelog
  6. Thank you to the Github team for your support! and thank you @billibala, @theoddbrick, @christopherbattlefrontlegal for sponsoring! you guys are amazing.
  7. - Full release history lives in [CHANGELOG.md](CHANGELOG.md).
  8. - 1.9.6
  9. - MAJOR FIX: Simplified `search_symbols` to be more predictable for AI agents
  10. - Added exact symbol resolution inside `search_symbols` for queries like `GridItem`, `View`, and `ButtonStyle`
  11. - Changed `search_symbols` to return symbol-first results with articles and guides separated into their own section
  12. - Fixed wildcard behavior so fallback search respects `*` and `?` patterns instead of degrading to plain substring matches
  13. - Removed misleading search messaging about background downloads and "comprehensive" indexing
  14. - Removed dead or unused search code paths that were adding confusion without improving results
  15. - Fixed first-search index initialization so cache-backed symbol search finishes building before results are used
  16. - 1.9.1
  17. - Moved cached docs into `.cache/` to keep the repo clean
  18. - Routed MCP logging to stderr so protocol stdout stays clean (this was breaking codex symbol search)
  19. ## Installation
  20. ## VS Code
  21. 1. Open Command Palette (`Shift+Cmd+P`).
  22. 2. Run `MCP: Add Server`.
  23. 3. When prompted for server type, choose `npm`.
  24. 4. Enter this package:
  25. ```text
  26. apple-doc-mcp-server
  27. ```
  28. ## Claude Code:
  29. ```bash
  30. claude mcp add apple-docs -- npx apple-doc-mcp-server@latest
  31. ```
  32. ## OpenAI Codex:
  33. ```bash
  34. codex mcp add apple-doc-mcp -- npx apple-doc-mcp-server@latest
  35. ```
  36. ## Manual:
  37. ```json
  38. {
  39. "mcpServers": {
  40. "apple-docs": {
  41. "command": "npx",
  42. "args": ["apple-doc-mcp-server@latest"]
  43. }
  44. }
  45. }
  46. ```
  47. ## Local:
  48. ```bash
  49. yarn install
  50. yarn build
  51. ```
  52. ```json
  53. {
  54. "mcpServers": {
  55. "apple-docs": {
  56. "command": "node",
  57. "args": ["/absolute/path/to/apple-doc-mcp/dist/index.js"]
  58. }
  59. }
  60. }
  61. ```
  62. ### Search Tips
  63. - Use exact API names when you know them (`"GridItem"`, `"ButtonStyle"`, `"View"`).
  64. - Start broad (e.g. `"tab"`, `"animation"`, `"gesture"`).
  65. - Try synonyms (`"sheet"` vs `"modal"`, `"toolbar"` vs `"tabbar"`).
  66. - Use wildcards (`"Grid*"`, `"*Item"`, `"Lazy*"`) for flexible matching.
  67. - Use multiple keywords (`"tab view layout"`) to narrow results.
  68. - If nothing turns up, re-run `discover_technologies` with a different keyword or pick another framework.
  69. - `search_symbols` returns symbols first and lists matching articles separately.
  70. ## Available Tools
  71. - `discover_technologies` – browse/filter frameworks before selecting one.
  72. - `choose_technology` – set the active framework; required before searching docs.
  73. - `current_technology` – show the current selection and quick next steps.
  74. - `search_symbols` – symbol-first search with exact-name resolution, wildcard support, and separate article results.
  75. - `get_documentation` – open detailed docs for a known symbol or documentation path.
  76. - `get_version` – get current MCP server version information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.