Apple 文档转 AI 友好格式工具

API 工具

searchAppleDocumentation 搜索 Apple Developer 文档

参数：query（字符串）

返回结构化结果，包含标题、URL、描述、面包屑导航和标签

fetchAppleDocumentation 按路径获取 Apple Developer 文档和 Human Interface Guidelines

参数：path（字符串）- 文档路径（例如：/documentation/swift、/documentation/swiftui/view、/design/human-interface-guidelines/foundations/color）

返回 Markdown 格式内容

fetchAppleVideoTranscript 按视频路径获取视频字幕，包括 WWDC sessions

参数：path（字符串）- 视频路径（例如：/videos/play/wwdc2021/10133、/videos/play/meet-with-apple/208）

返回 Markdown 格式内容

fetchExternalDocumentation 通过绝对 HTTPS URL 获取外部 Swift-DocC 文档

参数：url（字符串）- 外部 URL（例如：https://apple.github.io/swift-argument-parser/documentation/argumentparser）

返回 Markdown 格式内容

网络配置

如果遇到 MCP server 连接超时或网络问题，你可能需要配置代理。这在公司环境或网络受限地区特别常见。

通过添加环境变量来配置 MCP 客户端使用代理：

{
  "mcpServers": {
    "sosumi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://sosumi.ai/mcp"
      ],
      "env": {
        "HTTP_PROXY": "http://proxy.example.com:8080",
        "HTTPS_PROXY": "http://proxy.example.com:8080"
      }
    }  }
}

用你实际的代理服务器地址替换 proxy.example.com:8080。对于需要认证的代理，使用格式：http://username:password@proxy.example.com:8080

命令行用法

使用 npx（Node.js 内置）

直接运行：

npx @nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

如果经常使用，安装一次：

npm i -g @nshipster/sosumi

使用 bunx（Bun 内置）

直接运行：

bunx @nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

如果经常使用，安装一次：

bun i -g @nshipster/sosumi

使用 deno run

直接运行：

deno run -A npm:@nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

如果经常使用，安装一次：

deno install -g -A npm:@nshipster/sosumi

获取文档

获取 MCP 工具支持的任何内容类型——API 文档、Human Interface Guidelines、WWDC sessions 和外部 Swift-DocC 页面：

sosumi fetch /documentation/swift/array
sosumi fetch /design/human-interface-guidelines/color
sosumi fetch /videos/play/wwdc2021/10133
sosumi fetch https://apple.github.io/swift-argument-parser/documentation/argumentparser

搜索 Apple Developer 文档：

sosumi search "SwiftData"

默认输出为纯文本/Markdown 格式。添加 --json 用于脚本化处理：

sosumi fetch /documentation/swift/array --json
sosumi search "SwiftData" --json

服务器

从已发布的包运行本地服务器实例：

sosumi serve
sosumi serve --port 8787

安装为 skill

作为可复用 skill 安装（个人或项目级）：

# 个人 skill（所有项目）
mkdir -p ~/.claude/skills/sosumi
curl -o ~/.claude/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md

# 项目 skill（仅此项目）
mkdir -p .claude/skills/sosumi
curl -o .claude/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md

# 全局指令（所有项目）
mkdir -p ~/.agents/skills/sosumi
curl -o ~/.agents/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md

作为 Cursor skill 安装（全局或项目级）：

# 个人 skill（所有项目）
mkdir -p ~/.cursor/skills/sosumi
curl -o ~/.cursor/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md

# 项目 skill（仅此项目）
mkdir -p .cursor/skills/sosumi
curl -o .cursor/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md

对于 AGENTS 兼容工具，作为可复用 skill 安装：

mkdir -p ~/.agents/skills/sosumi
curl -o ~/.agents/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md