Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

[开源项目] Apple Docs 2.0 MCP:让 AI 编程助手先查 Apple 官方文档,再写 Swift

未关闭
#5,461 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
1/100
Issue 类型
功能
描述清晰度
需要澄清
活跃度
活跃
领域
content

调研方向

This issue is a project introduction and links to the Apple-Docs-2.0-MCP repository; it does not identify a change, files, tests, or an entry point in iOS-Weekly. Start by checking whether the linked project has a specific contribution task. Done cannot be determined from this issue alone.

由索引模型根据 Issue 内容生成。

描述

我是 Apple Docs 2.0 MCP 的开发者。它是一个 MCP 服务器,让 Claude Code、Cursor、Codex 等 AI 编程助手在写 Swift 代码之前,先查阅 Apple 的官方文档、人机界面指南(HIG)和 WWDC 视频。MIT 协议,无需 API 密钥或账号,一行即可使用:

npx -y apple-docs-2.0-mcp

推荐理由,主要是做这个项目时踩到的几个坑:

  • developer.apple.com/search 改为 JavaScript 渲染后,解析搜索页 HTML 的做法只能拿到 0 条结果。现在直接调用搜索页自己使用的接口,结果与网站一致,涵盖 API 参考、文章、示例代码、HIG、App Store Connect 帮助和 WWDC 视频。
  • 文档页面读取的是网站生成页面所用的 DocC JSON,再转成 Markdown(Swift 版本),包含每个成员的完整签名、继承关系、各系统版本的可用性和 See Also。Apple 提供的 .md 版本会丢掉 See Also 等内容,所以没有采用。
  • 只记得名称的一部分时,全文搜索常常找不到。项目附带一份离线索引,由 Apple 的导航索引、HIG 和 App Store Connect 帮助的目录生成,共 336,629 个页面,可以按名称或名称片段查找。
  • WWDC 2014–2026 的 1,700 个会议视频随包离线提供,其中 1,416 个附讲稿,715 个附代码示例;按代码里用到的类型(如 NavigationStack)就能找到对应的代码。
Apple Docs 2.0 MCP

仓库:https://github.com/mishafyi/Apple-Docs-2.0-MCP

主要语言
JavaScript
星标
5k
派生
431
平均合并
1 分钟
30 天内合并 PR
3

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

SwiftOldDriver/iOS-Weekly 的其他 Issue

查看 SwiftOldDriver/iOS-Weekly 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。