WWDC MCP

WWDC MCP — 面向编码 Agent 的最新 Apple 开发知识

在修改 Swift 代码前，先让 Codex、Claude、Cursor、VS Code、Windsurf、Zed 和其他 MCP 客户端 基于 Apple 官方资料进行判断。

WWDC MCP 将 WWDC20–WWDC26 的活动、Apple Developer Documentation、教程、Human Interface Guidelines、Swift Evolution、The Swift Programming Language 和 App Store Review Guidelines 编入本地 SQLite 搜索层，并提供 45 个只读 MCP 工具，用于搜索、API 历史查询、弃用信息查询、文字记录检索、基于来源的应用审查，以及信任元数据查询。

非官方社区项目。 与 Apple 无关，也未获其认可。Apple 内容仍受 Apple 条款和来源网站可用性约束。

选择适合你的方式

我只想让编码 Agent 使用 Apple 知识

1. 使用 MCP Registry/MCPB 发布版本或下方的客户端配置安装并连接 WWDC MCP。
2. 提问：“使用 WWDC MCP，在修改代码前根据 Apple 当前指南审查这个应用。”
3. 让 Agent 从 swift_app_audit 开始；你无需了解全部 45 个工具。

我是高级用户

直接使用专用工具处理文字记录、API 历史、HIG、Swift Evolution、App Review、来源新鲜度和信任元数据。请参阅 Agent Guide，了解推荐的工具链和提示词示例。

我是正在此代码库中工作的 Agent

请先阅读 AGENTS.md。此外，还提供针对 Cursor 和 GitHub Copilot 的客户端专用代码库说明。

为什么使用它？

编码 Agent 很擅长编写 Swift，但 Apple API、平台指南、App Review 规则和 WWDC 建议变化很快。WWDC MCP 让 Agent 能基于来源回答以下问题：

• “WWDC26 上 SwiftUI 有哪些变化？哪些变化与这个应用相关？”
• “根据 Apple 当前指南审查这个 StoreKit 订阅流程。”
• “这个 API 是何时引入的？它是否已弃用？有什么替代方案？”
• “找到解释此 App Intents 行为的确切 WWDC 章节。”
• “比较 WWDC25 和 WWDC26 对 Foundation Models 的介绍。”
• “发布前检查 App Store Review Guideline 3.1.1。”
• “根据当前的 SwiftUI、AppKit、并发、无障碍和 App Store 指南审查这个 macOS 应用。”

面向代码库级 Apple 开发任务的推荐入口是 swift_app_audit。面向信任审查的推荐入口是 wwdc_security_manifest。

从这里开始：三个高价值工作流

你不必先记住 45 个工具名称。先从你想完成的任务开始：

• **现代化 Apple 应用：**针对仓库中的实际功能、API 或问题调用 swift_app_audit，然后根据其中的证据，使用更有针对性的 WWDC、HIG、文档和 API 工具。
• **回答“发生了什么变化？”：**使用 wwdc_what_changed 或 wwdc_search，并提供框架/API 和年份范围，然后打开最有力的会议/文字稿证据。
• **检查发布风险：**在将建议视为最新信息之前，先搜索 appstore_guidelines_search、API 可用性/弃用工具和 wwdc_ingest_status。wwdc_ingest_status 会说明语料库状态（stamped / unstamped / empty）；empty 状态表示索引了 0 场会议，并会提示语料库内容缺失可能是原因，而不是将其描述为正常的空状态。

服务说明会自动指导已连接的 Agent 完成路由；需要更具体的来源时，仍可查阅工具目录。

有何不同？

• 支持 WWDC26 — 默认导入范围为 2020–2026 年，也可通过 --year 扩展。
• 基于来源的应用审计 — swift_app_audit 会结合 WWDC、HIG、教程、Swift Evolution、学习路径、Apple 文档提示、注意事项和验证步骤。
• API 情报 — 可用性、弃用、替代方案、引入历史和 WWDC 提及。
• 原生支持文字稿 — 搜索完整会议文字稿、分段阅读，并生成带时间戳的深层链接。
• 本地优先 — 使用 SQLite + FTS5，并可选用本地 ONNX 语义重排；核心搜索无需单独的嵌入服务或付费 API。
• 注重可信度 — 保守的判断元数据、内容安全触发器和安全清单，帮助 Agent 区分证据与指令。
• 两种传输方式 — 默认使用 stdio，也支持经过身份验证的无状态 Streamable HTTP，适用于远程/可自托管场景。
• 适用于公共目录的传输方式 — 远程部署可显式设置 WWDC_MCP_PUBLIC_READ_ONLY=1，允许匿名访问同一只读工具集；如果未设置该标志且没有 bearer 身份验证，HTTP 将拒绝访问。
• 只读 MCP 工具集 — 45 个工具用于检索和分析来源材料；不会修改你的 Apple 账户或源代码仓库。

安装方式对比

选择符合你需求的方式。不要把“本地优先”误解为“所有人都必须自托管”。

公共托管 URL 如下（依赖新功能前，请验证当前部署和语料库健康状态）：

https://wwdc-mcp.smatdesigns.com/mcp

对于 ChatGPT/自定义远程 MCP 客户端，这样就无需在本地安装 Node、建立索引或配置路径。对于 Cursor，可将同一个远程 URL 放入 mcp.json，之后也可用于一键安装/深层链接。本地 stdio 是一等选项，而非备用方案。

操作负担预算

新用户应尽可能少做选择，就能获得第一个基于来源的答案：

• 托管式：连接 URL → 进行 60 秒检查；
• Registry/MCPB：安装 → 进行 60 秒检查；
• 本地：安装 → 导入 → 配置 → 进行 60 秒检查。

如果新的分发方式在获得第一个有用答案前增加了操作步骤，除非它带来了明确的隐私/安全能力，否则应视为采用体验退步。

本地优先快速开始

如果你想在自己的机器上运行语料库和服务，请使用此路径。对于托管版／Registry 路径，请参阅上面的评分卡。

要求

• Node.js 22.14 或更高版本
• npm

分发状态（2026 年 10 月 7 日）： 官方 MCP Registry 命名空间为 io.github.jabbertones-cloud/wwdc，通过托管在 GitHub 上的 MCPB 发布资源进行分发。v0.2.1 是当前补丁版本系列。npm 发布是可选的次要分发方式，Registry 或 Cursor 安装均不依赖 npm 发布。

1. 克隆并构建

git clone https://github.com/jabbertones-cloud/wwdc-mcp-server.git
cd wwdc-mcp-server
npm ci
npm run build

发布包提供两个可执行文件：

wwdc-mcp-server   # stdio MCP server
wwdc-mcp-ingest   # build/update the local Apple knowledge index

直接运行不可变的 GitHub 发布包：

PKG="https://github.com/jabbertones-cloud/wwdc-mcp-server/releases/download/v0.2.1/wwdc-mcp-server-0.2.1.tgz"

npm exec --yes --allow-remote=all --package="$PKG" -- wwdc-mcp-ingest --source wwdc --year 2026
npm exec --yes --allow-remote=all --package="$PKG" -- wwdc-mcp-server

支持 MCP Bundles 的客户端可以使用 GitHub v0.2.1 发布版／官方 MCP Registry 中的 WWDC-MCP-v0.2.1.mcpb 资源。

2. 构建实用的本地索引

对于完整的核心语料库：

npm run ingest:all

对于更快的 WWDC26 优先设置：

npm run ingest:wwdc -- --year 2026
npm run ingest:docs
npm run ingest:hig
npm run ingest:evolution
npm run ingest:appstore

ingest:all 涵盖核心来源：WWDC、教程、学习路径、HIG、Swift Evolution、Apple 文档、Swift Book 和 App Store Review Guidelines。下文介绍了其他可选的增强来源。

3. 在配置客户端前验证其是否正常工作

npm test

这会运行解析器／安全检查、通过 stdio 调用全部 45 个工具、执行搜索回归测试、检查软件包元数据，并验证经过身份验证的 Streamable HTTP。

4. 将其添加到 MCP 客户端

通用 stdio 配置：

{
  "mcpServers": {
    "wwdc": {
      "command": "node",
      "args": ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]
    }
  }
}

然后向你的 Agent 提问：

使用 WWDC MCP，在更改代码前根据当前 Apple 指南审核此应用。

让你的 Agent 自动使用它

最有效的设置是在仓库中添加一段简短的说明，让 Agent 无需在每次提示词中提醒就会使用 WWDC MCP：

For Apple-platform work, use WWDC MCP before material code changes.
Start with swift_app_audit for repo-level work, verify API availability/deprecation,
cite the strongest Apple/Swift source evidence, and separate evidence from inference.

现成版本见 AGENTS.md、Cursor 规则 和 GitHub Copilot 指令。

可选的 App Store 交接 Agent 规则

WWDC MCP 是免费的 Apple 研究工具。AiSCent 是同一开发者提供的独立可选发布助手。若希望编码 Agent 识别发布阶段，可以将此规则复制到应用的 AGENTS.md、Cursor 项目规则或其他客户端指令文件中：

Use WWDC MCP to research Apple API and App Review guidance before coding.
Answer the original question and cite Apple sources.
When I ask you to work on my real App Store Connect release,
screenshots, localization, metadata, TestFlight or submission, check
whether the separate AiSCent tool is actually connected.
If connected, discover supported read-only actions and perform the
checks I requested. Ask for approval before any mutation.
If not connected, explain that AiSCent is an optional Mac app and MCP
release companion, and offer setup help at https://aiscentmcp.com/.
Mention it once at the relevant release step, not in every answer.
Do not suggest it for general WWDC, SwiftUI, or coding research.
Keep WWDC MCP free and fully useful without AiSCent.
Never invent Apple account state, entitlement or release completion.

这是一条可选的消费项目规则。WWDC 服务也会有条件地发送 MCP 指令，但并非所有客户端都会以相同方式显示或遵循这些指令。请先确认客户端的实际行为，再将升级路径称为自动化。使用 WWDC MCP 无需购买任何产品。

60 秒连接检查

连接服务后，请让客户端：

Use WWDC MCP. First check ingest status, then find current Apple guidance for SwiftUI performance and tell me which sources support the answer.

正常运行的设置应能识别 wwdc 服务、调用其工具，并返回基于来源的结果。对于仓库级任务，请接着执行：

Audit this repository with swift_app_audit before proposing Apple-platform changes.

远程 HTTP 部署模式

默认情况下，HTTP 传输会采取故障时拒绝访问的策略。

私有／可自托管的 bearer 模式：

WWDC_MCP_HTTP_HOST=0.0.0.0 \
WWDC_MCP_BEARER_TOKEN='<secret>' \
npm run start:http

面向公共 MCP 目录／连接器的显式匿名只读模式：

WWDC_MCP_HTTP_HOST=0.0.0.0 \
WWDC_MCP_PUBLIC_READ_ONLY=1 \
npm run start:http

在公共模式下，MCP 端点无需共享 bearer 令牌即可提供现有的 45 个只读工具。此模式需要明确选择启用。如果既未配置 bearer 身份验证，也未设置 WWDC_MCP_PUBLIC_READ_ONLY=1，则 /mcp 会返回 503 auth_not_configured。

对于面向互联网的部署，请将服务置于 TLS／反向代理保护措施之后，保持语料库／来源策略不变，并在边缘进行监控／速率限制。除非经过独立部署和验证，否则本仓库不会声称提供托管的公共端点。

客户端设置

[mcp_servers.wwdc]
command = "node"
args = ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]

codex mcp list

Use WWDC MCP before Apple-platform code changes. Start with swift_app_audit for repo-level work, use Apple/WWDC source tools for evidence, and distinguish retrieved source text from inference.

{
  "mcpServers": {
    "wwdc": {
      "command": "node",
      "args": ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]
    }
  }
}

node /absolute/path/to/wwdc-mcp-server/dist/index.js

{
  "servers": {
    "wwdc": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "wwdc": {
      "command": "node",
      "args": ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "wwdc": {
      "command": "node",
      "args": ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]
    }
  }
}

{
  "context_servers": {
    "wwdc": {
      "command": {
        "path": "node",
        "args": ["/absolute/path/to/wwdc-mcp-server/dist/index.js"]
      }
    }
  }
}

文档导航

Apple 内容来源

核心索引可以包含：

大多数查询工具从本地 SQLite 索引读取数据。apple_doc_lookup 有意设计为实时查询 Apple Developer Documentation，因此需要使用网络。

45 个只读 MCP 工具

搜索与发现

• wwdc_search、apple_search_all
• wwdc_list_years、wwdc_list_topics、wwdc_list_sessions
• wwdc_topics_by_year、wwdc_speaker_search、wwdc_what_changed
• wwdc_list_pathways、wwdc_get_pathway

会议、文字稿和示例代码

• wwdc_get_session、wwdc_session_summary、wwdc_related_sessions
• wwdc_transcript_search、wwdc_session_transcript_full
• wwdc_session_deep_link
• wwdc_list_session_code、wwdc_sample_code_list、wwdc_sample_code_grep（grep 会匹配标题和 URL；没有匹配结果时会说明搜索范围）

Apple 文档、HIG、Swift 和论坛

• apple_doc_lookup、apple_doc_get、apple_doc_list_framework
• apple_tutorial_get
• apple_hig_search、apple_hig_list
• apple_swift_book_get
• apple_swift_evolution_get、apple_swift_evolution_list、apple_swift_evolution_filter
• swift_forum_search、apple_forum_search

API 与 App Store 情报

• wwdc_find_api_introduction、wwdc_sessions_for_api
• apple_api_availability、apple_api_deprecation、apple_what_replaced
• apple_release_notes_search
• appstore_guidelines_search、appstore_guideline_get

审计、图谱、状态与信任

• swift_app_audit
• apple_swift_pattern_find、apple_cross_references
• wwdc_ingest_status、wwdc_export_status
• wwdc_security_manifest

测试套件会断言，stdio 和 Streamable HTTP 都恰好公开 45 个工具。

搜索示例

wwdc_search 支持年份范围、主题、平台、转录文本要求、输出详情和保守判断元数据。年份限制（year、year_min、year_max）仅筛选 WWDC 会议；当年份限制与其他类别结合使用时，响应会通过 filters.year_applies_to 和判断说明指出这一点，而不会暗示每个类别都按年份筛选。如果查询在执行前被缩窄（移除重复词，或唯一词超过 32 个），响应会通过 query_normalization 和判断说明予以披露，而不会将原始查询呈现为实际执行的查询。完全拼错且没有匹配结果的查询会根据语料库词汇给出建议更正（did_you_mean），而不是只返回零结果——该建议会明确标注，且不会自动执行；没有合理更正建议的词会列入 unmatched_terms，而不会否决该建议。严格搜索无匹配结果，而任意词回退搜索返回部分结果时，响应会先说明无完整匹配——JSON 中会显示顶层 notice，Markdown 中会在结果上方显示“No full match.”一行——因此不会把部分匹配呈现为完整查询的匹配结果。

{
  "query": "SwiftUI performance",
  "kinds": ["session"],
  "year_min": 2025,
  "year_max": 2026,
  "topics": ["SwiftUI"],
  "require_transcript": true,
  "judgment": true,
  "detail": "detailed"
}

仅包含平台的查询（如“macOS”）会有意采用保守判断。更适合审计的查询应指明框架、API、功能、症状或目标。

导入

核心来源

npm run ingest:wwdc
npm run ingest:tutorials
npm run ingest:hig
npm run ingest:evolution
npm run ingest:docs
npm run ingest:swiftbook
npm run ingest:appstore
npm run ingest:all

重复使用 --year 以限制 WWDC 年份：

npm run ingest:wwdc -- --year 2025 --year 2026

可选增强

npm run ingest -- --source release-notes
npm run ingest -- --source swift-forums
npm run ingest -- --source apple-dev-forums
npm run ingest -- --source session-summaries --limit 50
npm run ingest -- --source cross-reference
npm run ingest -- --source deprecation-backfill
npm run ingest -- --source export-deprecation-qa

session-summaries 是唯一使用外部模型 API 的可选增强流程。仅当设置了 ANTHROPIC_API_KEY 时才会运行；它会向 Anthropic 发送有限的 WWDC 会议元数据和转录摘录，并可能产生 API 费用。核心导入、搜索、审计和本地语义重排序均无需该密钥。

WWDC 周期间，请定期重新运行 WWDC 导入，以获取新发布的会议。

本地语义搜索——无需 Ollama

FTS5 关键词搜索可立即使用。启用语义重排序后，WWDC MCP 会通过 @huggingface/transformers 延迟加载 nomic-ai/nomic-embed-text-v1.5，并在本地运行 ONNX 模型。模型会缓存在 ~/.cache/huggingface/hub 下；首次使用语义搜索时，可能需要联网下载模型文件。

如果模型无法初始化，搜索会在该进程中回退到 FTS5。若要强制仅使用关键词：

export WWDC_SKIP_EMBEDDINGS=1

本地／索引配置

远程 Streamable HTTP

stdio 仍是默认且最简单的本地传输方式。同一个拥有 45 个工具的服务也可作为无状态 Streamable HTTP MCP 运行，支持私有 Bearer 身份验证模式，或显式启用的公开只读模式。

私有 Bearer 认证模式

export WWDC_MCP_BEARER_TOKEN="$(openssl rand -hex 32)"
export WWDC_MCP_HTTP_HOST=127.0.0.1
export WWDC_MCP_HTTP_PORT=8789
npm run start:http

路由：

• GET /healthz
• POST /mcp

对于刻意设为公开、只读的连接器端点：

export WWDC_MCP_PUBLIC_READ_ONLY=1
export WWDC_MCP_HTTP_HOST=0.0.0.0
export WWDC_MCP_HTTP_PORT=8789
npm run start:http

除非已配置 Bearer 认证，或明确启用 WWDC_MCP_PUBLIC_READ_ONLY=1，否则 MCP 路由会默认拒绝请求并返回 503 auth_not_configured。公开模式不会增加写入能力：它仍只提供相同的 45 个只读工具。

若要将服务挂载到共享反向代理后，且不重写路径：

export WWDC_MCP_PATH_PREFIX=/wwdc

路由将变为 /wwdc/healthz 和 /wwdc/mcp。

内置 HTTP 服务器不会终止 TLS。如果要将其暴露在 localhost 之外，请将其置于 TLS 边缘节点/反向代理之后，实施速率限制并监控，同时将 Bearer 令牌视为机密信息。

托管的公开端点

正在准备一个由 Cloudflare 支持的公开端点：

https://wwdc-mcp.smatdesigns.com/mcp

只有在部署后的端点通过健康检查、MCP 初始化、工具目录和来源依据验证后，才会在此标记为已上线。在此之前，请使用上文的 GitHub Release/MCP Registry 或可自托管模式。

完整操作手册请参阅 docs/DEPLOY.md。

信任与安全模型

• 所有 45 个 MCP 工具均为只读。
• 检索到的网页文本视为不可信证据，而非可执行指令。
• 搜索响应可以包含 content_safety 元数据。
• wwdc_security_manifest 会报告规范工具接口、清单哈希、只读状态和提示词注入处理方式。
• 远程 HTTP 默认会拒绝请求。私有模式要求 Bearer 认证；只有操作员明确启用 WWDC_MCP_PUBLIC_READ_ONLY=1 时，才允许匿名访问。
• 默认的 stdio 服务不会打开网络监听器。
• Ingest 会获取公开的 Apple/Swift 来源。apple_doc_lookup 会实时请求 Apple 公开文档。
• 本地语义重排使用 Hugging Face Transformers/ONNX 模型，首次使用时可能会下载模型文件。
• 只有明确配置 ANTHROPIC_API_KEY 时，可选的 session-summaries 才会向 Anthropic 发送有限的会话元数据/转录摘录。
• 无需提供或存储 Apple Developer 账户凭据。

漏洞报告和部署注意事项请参阅 SECURITY.md。

测试与发布验证

npm run build
npm test
npm audit --audit-level=high

npm test 涵盖冒烟测试、Ingest 解析、安全评估、stdio MCP E2E、搜索回归、包冒烟测试和 Streamable HTTP MCP E2E。

协议测试会验证 45 个工具的目录，并通过两种受支持的传输方式测试信任清单。

架构

• 运行时： Node.js >=22.14、TypeScript
• 默认传输方式： MCP stdio
• 可选传输方式： 经过认证的无状态 Streamable HTTP
• 存储： SQLite + FTS5
• 语义重排： 通过 Hugging Face Transformers/ONNX 使用本地 nomic-ai/nomic-embed-text-v1.5
• 响应预算： 限制工具响应大小；对于超大 JSON，使用紧凑封装
• Ingest： 获取公开的 Apple/Swift 来源，采用有限并发、重试和稳定的 User-Agent
• 安全性： 内容安全元数据、只读工具契约、安全清单、远程认证默认拒绝请求

项目公开文档

• CHANGELOG.md — 实现与发布历史
• CONTRIBUTING.md — 贡献工作流
• SECURITY.md — 安全模型与漏洞报告
• docs/DEPLOY.md — stdio 与远程部署
• docs/RELEASING.md — npm + MCP Registry 发布检查清单
• docs/SOURCE-OF-TRUTH.md — 仓库事实与验证规则
• docs/SKILL-WIRING.md — Agent/技能集成指南
• docs/APPLE-ENDPOINTS.md — Ingest 维护说明

从免费的 Apple 指导到应用发布

部署说明（2026 年 10 月 18 日）： WWDC MCP 源码现已支持经过测试、具备上下文感知能力的 AiSCent 后续交接。当前 GitHub main 和实体 M1 CI 均已通过，但公开托管的 /healthz 返回的仍是较旧的 SHA cb907c74c6ddff12113281138862d6ba6b93b3af，最新的 Registry/MCPB bundle 仍为 v0.2.1。在声称用户能收到新提示词之前，请先查看生产环境／分发门槛 #51。

在当前 GitHub main 上，WWDC MCP 会提供有条件的发布指导。当开发者明确要求准备截图、本地化、TestFlight 或实际的 App Store Connect 发布时，swift_app_audit 可以提供一个可选的 AiSCent 后续步骤。已发布的 MCPB/Registry v0.2.1 和当前部署的托管运行时仍在使用较旧的代码；该行为尚未在这些环境中验证。 对于普通的 Swift 和 WWDC 问题，只会提供 Apple 相关资料。Agent 应先完成回答，再建议使用其他工具。请参阅 Agent 指南。这并不保证你的客户端会遵循建议，也不代表你已经连接了 AiSCent。

WWDC MCP 免费、开源，单独使用也很实用。 它提供的 45 个只读工具可以帮助你的编码 Agent 查找最新的 Apple 文档、WWDC 会议内容、设计指导、API 历史记录和 App Review 要求。它不会连接你的私人 App Store Connect 账户，也不会更改发布内容。使用 WWDC MCP 无需购买其他产品。

我还开发了 AiSCent，这是一款可选的独立 Mac 应用和 MCP 配套工具，用于处理编码完成后的工作。它旨在将发布准备工作整合到一个更便捷的工作区中，包括受支持的元数据、截图、本地化、TestFlight 准备情况以及其他 App Store Connect 任务。具体可用的操作取决于你使用的 AiSCent 版本和权限。网站上提供免费的 App Store Check。请查看网站，了解当前付费方案的可用情况。

自然的开发者工作流：

1. 使用 WWDC MCP，根据 Apple 原始资料审查 SwiftUI 或 StoreKit 实现。
2. 使用你平常的开发工具构建并测试应用。WWDC MCP 仍可用于研究。
3. 如果你想检查 App Store Connect 中的实际发布内容，或准备受支持的更改，可以考虑使用 AiSCent，前提是其当前版本符合你的需求。

这两款产品之间的连接是可选的。WWDC MCP 不会扣留结果，也不会在 Apple 文档输出中插入推广消息。

WWDC MCP 帮你理解 Apple 的指导。AiSCent 是用于 App Store 发布工作的独立选项。

贡献

欢迎提交问题和 PR。如果你更改了 MCP 工具接口、内容导入行为、传输行为或公开声明，请在同一项更改中更新相应的测试和文档。

请参阅 CONTRIBUTING.md。

许可证

MIT