[开源项目] Apple Docs 2.0 MCP:让 AI 编程助手先查 Apple 官方文档,再写 Swift
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 1/100
- Issue 类型
- 功能
- 描述清晰度
- 需要澄清
- 活跃度
- 活跃
- 技术栈
- javascript, node.js, swift
- 领域
- 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)就能找到对应的代码。
- 主要语言
- JavaScript
- 星标
- 5k
- 派生
- 431
- 平均合并
- 1 分钟
- 30 天内合并 PR
- 3
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
SwiftOldDriver/iOS-Weekly 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 83/100
SwiftOldDriver/iOS-Weekly#5454 ·
-
难度 1/5 1 小时以内 新手友好度 75/100
SwiftOldDriver/iOS-Weekly#5451 ·
-
难度 1/5 1 小时以内 新手友好度 75/100
SwiftOldDriver/iOS-Weekly#5450 ·
-
难度 1/5 1 小时以内 新手友好度 12/100
SwiftOldDriver/iOS-Weekly#5462 ·
-
难度 2/5 1-3 小时 新手友好度 18/100
SwiftOldDriver/iOS-Weekly#5458 ·
查看 SwiftOldDriver/iOS-Weekly 的全部 Issue
相似的 Issue
-
good first issue
难度 1/5 1 小时以内 新手友好度 88/100
saayam-for-all/webapp#1919 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 70/100
Uuriko/project-room#3728 ·
维护者通常 1 天内回复
-
documentation
难度 2/5 1-3 小时 新手友好度 62/100
devops-thiago/ThrillhouseBot#1132 ·
维护者通常 1 天内回复
-
documentation
难度 2/5 1-3 小时 新手友好度 74/100
andromarces/agent-loops#886 ·
维护者通常 1 天内回复
-
bug effort:low model:light plan planner:gpt-6-1-sol tests
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复