なぜ私がApple Docs MCPを作ったのか - AlarmKit開発で見えたAIの限界

アラームアプリ開発で直面した問題

「最新のAlarmKit APIを使ってアラームアプリを作りたい」

今年のWWDC25で発表されたAlarmKitを見て、すぐに開発を始めた。これまで通知APIで無理やり実装していたアラーム機能が、ついに公式APIで実装できる。AIアシスタントを使えば、開発も効率的に進むはずだった。

しかし、現実は違った。

AIアシスタントの限界

私：AlarmKitを使ってアラームを作成する基本的なコードを書いて

AI：申し訳ありません。AlarmKitというフレームワークは
    私の知識にありません。もしかしてUserNotificationsや
    UNNotificationRequestのことでしょうか？

当然だ。AIモデルの学習データは過去のもの。最新のWWDC25やiOS 26の内容なんて知るはずがない。

仕方なくApple Developer Documentationを開いて手動で調べ始めたが、これがまた大変だった。

• ドキュメントの検索が非効率（ブラウザで何度も検索）
• APIの正確な使い方が分からない
• 関連APIを見つけるのに時間がかかる
• サンプルコードが散在していて見つけにくい
• 最新のベータAPIの情報が整理されていない

「これじゃ開発が進まない...」

3時間かけて、やっと基本的なアラーム作成コードを動かせた。でも、これでは効率が悪すぎる。

解決策：Apple Docs MCPの開発

「待てよ、AIが最新のAppleドキュメントにアクセスできれば...」

そこで閃いた。Model Context Protocol（MCP）を使えば、AIに最新のドキュメントを理解させることができるはずだ。

早速開発を始めた。目標は明確だった：

1. Apple Developer Documentationに直接アクセス
2. 最新のドキュメントをAIが理解できる形で提供
3. 検索、API詳細、サンプルコード、関連APIをすべて統合
4. WWDC動画の内容も含める

2週間の開発期間を経て、Apple Docs MCPが完成した。

劇的な変化：開発効率が10倍に

自分で作ったApple Docs MCPをセットアップして、同じ質問をしてみた：

claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest

私：AlarmKitを使ってアラームを作成する基本的なコードを書いて

Claude：AlarmKitのドキュメントを確認しました。iOS 26で導入された
       このフレームワークでアラームを作成する方法を説明します：

       [正確なコード例が即座に表示される]

信じられない！AIが最新のAlarmKit APIを完璧に理解している。しかも：

• Info.plistの設定も教えてくれた
• Widget Extensionが必要なことも指摘
• エラーハンドリングまで含んだ実装
• 3時間かかったコードが5分で完成

これは革命的だった。

Apple Docs MCPがもたらした開発革命

自分のアラームアプリ開発で、Apple Docs MCPの威力を実感した：

1. 瞬時のAPI検索

Before（Apple Docs MCP前）:

• ブラウザで検索 → 複数のページを開く → 正しいAPIを探す
• 所要時間：15-30分

After（Apple Docs MCP後）:

私：AlarmManagerのすべてのメソッドを表示して

Claude：[即座に全メソッドとその説明が表示される]

• 所要時間：10秒

2. 関連APIの自動発見

Before:

• 関連するAPIを手動で探す
• ドキュメントを行ったり来たり
• 重要なAPIを見逃すことも

After:

私：AlarmManagerに関連するすべてのAPIを教えて

Claude：関連APIを分析しました：
       - AlarmConfiguration（設定）
       - AlarmSchedule（スケジューリング）
       - AlarmAttributes（表示カスタマイズ）
       - Alarm.CountdownDuration（タイマー設定）
       [その他10個以上の関連API]

3. 正確なコード生成

Before:

• ドキュメントを見ながら手探りでコード作成
• コンパイルエラーの繰り返し
• 正しい実装まで数時間

After:

私：AlarmKitで繰り返しアラームを実装して

Claude：[最新のAPIを使った完璧なコードが生成される]

• コンパイルエラー：ゼロ
• 実装時間：5分

開発効率は本当に10倍になった

私のアラームアプリ開発での実績：

開発時間の比較

タスク	Apple Docs MCP前	Apple Docs MCP後	改善率
API検索	30分	30秒	60倍
コード実装	3時間	15分	12倍
エラー解決	1時間	5分	12倍
全体の開発期間	3週間（予定）	3日（実績）	7倍

正確性の向上

最も重要なのは、コードの正確性が劇的に向上したこと：

• 誤ったAPI使用：ゼロ（以前は試行錯誤の連続）
• 非推奨APIの使用：ゼロ（AIが最新のAPIを提案）
• ベストプラクティス：自動的に適用される

なぜApple Docs MCPを公開したのか

自分のアラームアプリ開発が成功した後、考えた。

「この問題で困っているのは私だけじゃないはずだ」

実際、開発者コミュニティでは：

• 最新APIの情報不足に悩む声
• AIツールが古い情報しか知らない問題
• ドキュメント検索の非効率さへの不満

そこで、Apple Docs MCPをオープンソースとして公開することにした。

Apple Docs MCPの機能

公開したApple Docs MCPには、私が開発中に「あったらいいな」と思った機能をすべて実装した：

1. 包括的なドキュメントアクセス

• 🔍 スマート検索（最新のiOS 26 APIも含む）
• 📚 完全なAPI詳細情報
• 🔧 フレームワーク構造の可視化
• 📋 テクノロジーカタログ

2. WWDC動画統合

• 🎥 セッション検索とトランスクリプト
• 💻 コード例の抽出
• 📺 タイムスタンプ付き解説

3. 開発支援機能

• 🔗 関連API自動発見
• 📊 プラットフォーム互換性分析
• 💡 サンプルコードライブラリ
• 🎯 類似API提案

より多くの開発者に使ってもらいたい

Apple Docs MCPを公開したばかりだが、同じような問題で困っている開発者は多いはずだ。

このツールが提供する価値：

• 🚀 最新APIへの即座のアクセス
• 🎯 正確なコード生成
• 📚 WWDC動画コンテンツの統合
• 🔍 高速なドキュメント検索

もしあなたも：

• iOS 26の新APIについてAIに質問したい
• 最新のSwiftUI機能を効率的に学びたい
• WWDC動画から必要な情報を素早く見つけたい
• Apple開発の生産性を向上させたい

ぜひ試してみてほしい。きっと開発体験が変わるはずだ。

まとめ：問題解決から生まれたツール

私のアラームアプリ開発の苦労から生まれたApple Docs MCP。

最初は自分の問題を解決するためだけのツールだったが、今では世界中の開発者に使われている。

教訓：

• 自分が困っている問題は、他の人も困っている
• AIの限界は、適切なツールで補完できる
• オープンソースは開発者コミュニティを豊かにする

もしあなたもApple開発で最新APIの情報に困っているなら、ぜひApple Docs MCPを試してほしい。きっと開発効率が劇的に向上するはずだ。

---

セットアップは簡単

# Claude Code に Apple Docs MCP を追加
claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest

詳細は GitHub で。

注：AlarmKitはiOS 26の新機能です。この記事執筆時点（2025年7月）では、Xcode 26 beta が必要です。