ios-agent-skill

Name: ios-agent-skill
Author: Nagarjuna2997

ローカル

github.com/Nagarjuna2997開発ツール40今日更新

リポジトリ

ios-agent-skill について

ios-agent-skillは、SwiftとローカルのApple資料を使ってiOSアプリを構築・レビューするコーディングエージェント向けのツールキットです。アプリのひな型、コードレビュー、アセット生成、Xcodeシミュレーターでの確認を備え、MCPサーバーとクライアント別の設定ガイドも含みます。

主な機能

01説明からSwiftUIアプリを計画・生成
02編集可能なスタータープロジェクトの作成
03ローカルのSwiftソースとApple資料の検索
04Swiftコードとアプリ設定のレビュー
05シミュレーターでビルド、テスト、起動、撮影
06デザインパレットとアプリアイコンの生成

活用シーン

01短い要件からiOSアプリの草案を作成
02既存のSwiftプロジェクトをレビュー
03シミュレーターでビルドとテストを確認
04スクリーンショットを準備し配色違いを確認

MCP 対応

レビュー、資料検索、アセット、シミュレーターのツールを備えたMCPサーバーが含まれます。Claude、ChatGPT/Codex、Gemini CLI、Muse Code向けの設定ガイドがあります。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "nagarjuna2997-ios-agent-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ios-agent-mcp"
      ]
    }
  }
}

起動コマンドnpx -y ios-agent-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmios-agent-mcp2.6.0stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
path	string	はい	Swift プロジェクトルートの絶対パス（Package.swift または .xcodeproj を含むフォルダー）。
onscreenContent	boolean	いいえ	Siri が表示中のコンテンツを参照する必要がある場合に限り、画面上のエンティティ関連付けを確認します。
appleIntelligence	boolean	いいえ	依頼された Apple Intelligence 統合のエンティティスキーマを確認します。通常の intent では不要です。

詳細

iOS エージェントスキル

iOS アプリの構築やレビューに必要な Apple のリファレンス、Swift のソースコード、ローカルツールをコーディングエージェントに提供します。

ウェブサイトの紹介動画を見る · ウェブサイトを見る

アプリの説明を一文で入力すると、/ios-build エージェントが計画を立て、SwiftUI コードと Xcode プロジェクトを作成し、シミュレーターでビルドして実行します（検証済みの内容、ウェブサイトのサンプルアプリ）。既存のプロジェクトでは、同じパッケージを使って、コーディングエージェントにレビュー、ローカルの Apple リファレンス、作業を確認するシミュレーターツールを提供できます。

ウェブサイトを見る · クライアントのセットアップガイド · npm · リリースノート

一文からアプリを構築する

/ios-build "<what you want>" を実行すると、Claude Code が iOS アプリの計画を立て、SwiftUI コードと Xcode プロジェクトを作成し、機能モジュール（サインイン、ストレージ、決済、マップなど）を適用してから、iOS シミュレーターでビルド、実行、スクリーンショットの撮影を行います。最後に、アカウントや費用が必要な項目をレポートします。公開済みのツールは ios-agent-mcp 2.10.2（npm で 2026 年 10 月 15 日に確認済み）に含まれています。計画に基づくデザイントークン、サンプルデータ、パレットに合わせたアセット、ライト／ダーク／XXL のスクリーンショットによる証拠、デプロイメントターゲットの確認、App Store 対応状況のレポートなどを利用できます。既存の 4 つのアプリを Xcode 27.0 でビルドし、実行しました。更新された証拠については、examples/agent をご覧ください。

クイックスタート

公開済みのサーバーと Claude Code コマンドをインストールします。

claude mcp add ios-agent -- npx -y ios-agent-mcp@latest
npx -y ios-agent-mcp@latest install-command --global

次に、Xcode 16 以降を搭載した Mac で、任意の Claude Code セッションを開いて実行します。

/ios-build "A habit tracker with a list, a detail screen, and settings with dark mode toggle"

リリース準備（未リリースの GitHub ソース）： ios-agent-mcp ship はスクリーンショット一式とメタデータを準備し、その後、承認を個別に行う署名／アーカイブと TestFlight へのアップロードの手順を提示します。セットアップと制限事項。署名済みの配布はまだ検証されていません。npm に変更はありません。

Windows／Linux またはクラウドクライアント： GitHub ソースには、署名なしのビルドと GitHub Actions でのシミュレーターのスクリーンショット撮影に対応する build --remote が追加されました。宛先リポジトリ、GitHub CLI の認証、バージョンを固定したツールキットと Xcode が必要です。リモート macOS のセットアップと料金をご覧ください。npm への公開は延期されています。

XcodeGen は任意です。XcodeGen がない場合、エージェントはフォルダー同期型の Xcode プロジェクトを自ら作成します。手順は docs/tooling/ios-build-agent.md に記載されています。4 つのスクリーンショット例では、既存のアプリフォルダーを再利用しました。この一文だけで始めるクイックスタートは、計画からコード生成までを 1 回の Mac セッションで実行したことはまだありません。

例

習慣トラッカー	検索機能付きメモ	3タブフィード	フードデリバリー

計画、生成されたソース、実行レポート、実施したテストと未実施のテストについては、examples/agent を参照してください。

機能

各機能は、マニフェスト、レシピ、Swift テンプレート、適用フック、検証フックを含む capabilities/ 内のフォルダーです。カタログには、計画やコストの見積もりに役立つ幅広い機能が掲載されています。以下の件数はマニフェストから生成されています。

ステータス	機能数
Mac で検証済み	7
モジュールは存在するが、Mac では未検証	41
...うち、Swift が Mac でコンパイル済み（統合コンパイルチェック）	41
ブロック中	0
計画用のみ掲載	114

31 カテゴリーに 162 件のカタログ項目があります。capabilities/CATALOG.md から生成されています。

ご自身のアカウントが必要です

エージェントはアカウントなしで、シミュレーター上ですべてをビルドして実行します。サービスを必要とする機能は、必要なキーをマニフェストで宣言します。公開可能なキーなどのクライアントキーは、プロジェクトの Git 管理対象外の .env ファイルに記述され、生成された xcconfig を通じてアプリに渡されます。キーが設定されるまでは REPLACE_ME のプレースホルダーとなるため、アプリは引き続きビルドされ、設定に関するメッセージが表示されます。サーバーシークレットがアプリに含まれることはありません。各実行に必要なものとサービスごとのコストモデルは PLAN.md に記載されています。デバイスでの実行、TestFlight の利用、公開には、Apple Developer Program のメンバーシップが必要です。

未対応の項目

design-system、firebase-auth、firebase-firestore、google-sign-in、stripe-payments、rive-animation、webview-animation の各機能は、Mac での個別コンパイル検証に合格しています。プロバイダーのアカウントと実行時のトランザクションは未検証です。統合コンパイルチェックは、各モジュールの検証実行の代わりにはなりません（コンパイルチェックを参照）。
既存の以下 4 つのサンプルでは、エージェントによるビルド、シミュレーターの起動、画面ごとのキャプチャの各段階を Mac で実行しました。元の計画セッションとコード生成セッションは別々に行われており、Mac 上で一文の指示から新規生成までをエンドツーエンドで実行するテストは、まだ行っていません。
エージェント自身によるスクリーンショット撮影中のタップやスクロール、およびデバイス向けビルドは未対応です。フードデリバリーのサンプルでは、StoreKit の購入処理と Live Activity はテストしていません。

使用するワークフロー

目的	使用するもの	備考
説明から新しいアプリをビルドする	Claude Code で `/ios-build "<description>"` を実行するか、`ios-agent-mcp build`	計画、コード作成、ビルド、実行、スクリーンショット撮影を行います。上記を参照してください。npm 2.10.2 および GitHub main で利用できます。
既存のプロジェクトをご自身の受け入れテストに合格させる	`ios-agent-mcp loop`	作成したチェックを実行し、失敗があれば Claude に修正を依頼します。アプリ構築ループとReading List デモを参照してください。
編集可能なスターターのみを取得する	`ios-agent-mcp new MyApp`	概要付きの出発点であり、完成したアプリではありません。
既存のコードをレビューまたは拡張する	以下の MCP ツール	ファイル単位のレビュー、ローカル参照、アセット、シミュレーターのチェックを行います。

まずは1つの接続から

Claude Code の場合：

claude mcp add ios-agent -- npx -y ios-agent-mcp@latest

ChatGPT/Codex、Gemini CLI、または Muse のセットアップ。1つの npm パッケージに、レビュー、ローカルリファレンス、アプリのひな形作成、シミュレーターツールが含まれています。Node.js 20 以降が必要です。ローカルで iOS をビルドするには macOS と Xcode が必要です。GitHub ソースのリモートレーンでは、これらの手順を Actions で実行します。

次のように依頼します：

ローカル永続化、検索、アクセシブルな空状態／エラー状態を備えた SwiftUI の読書リストを作成してください。ローカルのソースライブラリを再利用してください。ビルドしてテストを実行し、シミュレーターの証跡を取得してください。失敗したチェックがあれば説明してください。

既存のアプリについては、絶対パスを指定して、変更を加える前に対象を絞ったレビューを依頼します。

できること

機能	内容
ひとことからアプリを作成	ios-build エージェントが画面、データ、機能を計画し、SwiftUI と Xcode プロジェクトを作成した後、シミュレーターでアプリをビルド、実行し、スクリーンショットを撮影します。ios-agent-mcp 2.10.0 で利用できます。
アプリを開始	編集可能な Swift スターター、実装概要、オプションの XcodeGen 仕様を用意します。
Apple の知識を再利用	ローカルの Swift ソースやガイドを範囲を限定したセクション単位で検索できるほか、Apple のテクノロジーとリリースノートを日付順にまとめたディレクトリを利用できます。
Swift コードをレビュー	並行処理、アーキテクチャ、SwiftUI、利用可能性、セキュリティ、パフォーマンス、App Intents に関する指摘をファイル位置とともに示します。
デザインアセットを生成	ライト／ダーク／ハイコントラスト向けの名前付きカラーと、編集可能な SVG レイヤーからローカルでレンダリングされる不透明な 1024px アプリアイコンを生成します。
アプリのカラーシステムをレビュー	セマンティックパレットを生成し、ライト、ダーク、ハイコントラストのカラー証跡を確認します。
バックエンド連携をレビュー	対応サービスを特定し、認証情報、認証、ポリシー、ネットワーク通信の証跡をローカルで確認します。
シミュレーターで検証	Xcode を通じてビルド、テスト、インストール、起動を行い、スクリーンショットを撮影します。
起動画面をレビュー	起動設定、ストーリーボード、アセット参照を、対象に応じた慎重なチェックで確認します。
ローカルリリースのドラフトを準備	Apple に接続せずに、選択したターゲットの情報、未解決の疑問、ハッシュ付きで再開可能なローカルパッケージを確認します。
App Store Screenshot Studio（GitHub ソース）	キャプチャを再利用可能なレイアウト、中立的なフレーム、プレビューギャラリー、検証済み PNG エクスポートを備えたローカライズ済みスクリーンショットセットに変換します。
Apple システムとの連携（GitHub ソース）	権限と機能の証跡を確認しながら、カレンダー、リマインダー、連絡先、写真、カメラ、マップ、ファイル、共有、ショートカット、通知をプレビューしてレビューします。

アセット生成 · レビューツール · シミュレーターのセットアップ · Apple リリース状況

スターターを直接作成します：

npx -y ios-agent-mcp@latest new MyApp --brief "A reading list with local storage" --xcodegen

スターターは完成済みのアプリではありません。--xcodegen は project.yml を作成し、XcodeGen がそれをプロジェクトに変換します。説明から完全なアプリを作成するには、/ios-build を使用してください。生成されたアプリの所有権とブランディングはユーザーに帰属します。

根拠を見る

Reading List のデモには、永続化、検索、シミュレーターでの受け入れテスト、キャプチャした画面が含まれています。/ios-build エージェントが計画して作成した4つのアプリと、その計画、実行レポート、シミュレーターのスクリーンショットは、examples/agentにあります。

公開されているnpm 2.10.2パッケージには、ビルドエージェントのツール、デプロイメントターゲットのチェック、App Store対応状況レポートが含まれています。これらには、7つのAppleシステム統合ツールと9つのScreenshot Studioツールが含まれています。静的レビューはヒューリスティックであり、コンパイラーの診断ではありません。Appleディレクトリはリファレンスマップであり、Apple独自のフレームワークのソースでも、405件の統合が動作することの証明でもありません。トークン削減効果はベンチマークされていません。ビルドループ検証の制限。

Xcodeと併用する理由

Xcodeには、エージェントの専門知識とビルド／テストツールがすでに付属しています。ニーズに合う場合は、それらを使用してください。このリポジトリでは、これら4つのクライアントファミリーに共通するガイダンス、確認可能なレビュー規則、ローカルでのソース取得、再現可能なアセットのワークフローを追加します。AIの性能がXcodeのスキルを上回る、または使用するトークン数が減ることは、確認されていません。

ガイダンスの出所、根拠、未完了の作業。ペア比較ベンチマークハーネスには、20件のSwiftマイクロタスクが含まれています。結果は公開されておらず、完全なアプリのビルドもまだ測定していません。

ツールの改善にご協力ください

失敗に関するフィードバックは、コーディングセッション内で行ってください。観測されたエラー、提案された修正、実際の検証結果を含めます。ソースサーバーは、返されるツールエラーにトラブルシューティングのガイダンスを追加します。エージェントへの指示では、コンパイラーやテストの失敗についても説明しています。これらのメッセージは、構築中のアプリには表示されません。

iOS Agentのツールが失敗したときに、AIがローカルレポートを作成できるようにするprepare_issue_reportがあります。固定カテゴリのみを受け付け、プレビューと重複検索へのリンクを表示します。公開するかどうかはユーザーが決めます。アプリのソースやログは収集されません。報告ワークフロー。

2.7.1で実験的なツールとして追加されたprivate_feedbackは任意で利用できます。AIチャット内で承認を行い、設定済みのHTTPSレシーバーを通じて固定カテゴリをプライベートな受信箱に送信します。ホスティングは設定されていないため、プライベートな送信機能はまだ利用できません。黙って送信したり、公開課題への送信にフォールバックしたりすることはありません。

4つのクライアントファミリー、1つのプロジェクト

クライアント	セットアップと確認状況
Claude	ローカル MCP とソーススキルに対応します。コーディングエージェントは Claude クライアントが提供します。
ChatGPT / Codex	Codex のローカル MCP、ChatGPT のスキルパッケージ、または別途設定した HTTPS／プライベートトンネル経由の MCP 接続に対応します。利用可否はアカウントやワークスペースのポリシーによって異なります。
Gemini CLI	拡張機能の設定とローカル MCP 接続を確認済みです。
Muse Code	スキルの検出、MCP の検出（36 ツールを備えた 2.7.0 サーバー）、Stop フックを確認済みです。モデルセッションとオブザーバーの動作は未確認です。

このプロジェクトは、これら4つのファミリーに重点を置いています。別のクライアントをお使いの場合は、クライアントサポートのリクエストを作成するか、既存のリクエストに👍を付けてください。投票は、実現可能性やテスト状況とあわせて優先順位の決定に役立てられますが、提供を保証するものではありません。既存の実験的なアダプターは積極的にメンテナンスされていません。

install.shの使用は任意です。選択したローカルクライアント向けのソースガイダンスをインストールするものであり、MCP サーバーやブラウザープラグインをインストールするものではありません。クローン後にbash install.sh --helpを実行してください。ほとんどのユーザーには、上記のクライアントセットアップガイドの利用をおすすめします。

対応状況の概要

Apple カタログの追跡対象：99のテクノロジー。対応済み：99。計画中：0。対象外：0。非推奨：0。対応率：100.0%。

情報源：frameworks.json。人間向けの索引：docs/apple-framework-index.md。

対応件数はドキュメントの数を示すものであり、コンパイル済みの統合機能の数ではありません。ダウンロード数は毎日更新され、ユニークユーザー数ではありません。

貢献 · 開発 · セキュリティ · ロードマップ · MIT ライセンス

バックエンド統合のガイダンス：サービスを選び、認証、データ、セキュリティの境界を確認してください。

任意のプロバイダーコマンド

ios-agent-mcp environmentを使って、実際の Xcode／SDK／シミュレーターの一覧を確認します。 ios-agent-mcp ai modelsとai doctorを使って、日付付きのカタログとアカウント／ローカルでの利用可否を確認します。テキスト生成では、デフォルトでオンデバイスの Apple モデルを使用します。クラウドプロバイダーとフォールバックを利用するには、明示的な設定が必要です。プロバイダーのセットアップ、引き継ぎ、シミュレーター CLI、制限事項。これらのコマンドはコーディングクライアントに代わるものではなく、アプリを自律的に完成させると主張するものでもありません。

ローカルの Apple ドキュメント

アーカイブを Xcode → Settings → Components → Developer Documentation でインストールします。Window → Developer Documentation（標準のキー割り当てでは Shift–Command–0）から閲覧できます。この統合ではxcrun mcpbridgeを使用し、アーカイブは Xcode が管理します。

xcode-mcp toolsを使って検出された Xcode スキーマを確認し、doctor xcodeを使ってセットアップを診断します。

ios-agent-mcp docs statusとios-agent-mcp docs symbol SwiftUI.NavigationStackを使って、バージョンに応じたドキュメント情報を取得します。このアダプターは、まず Xcode MCP DocumentationSearch を使用し、次に範囲を限定した SDK の根拠を参照します。Apple のアーカイブは同梱されません。ブリッジの認証が必要です。情報の取得はコードの自動検証ではありません。セットアップ、ツール、制限事項。

実験的なネイティブソースのインポート

機能ブランチの App IR プロトタイプは、範囲を限定したローカル HTML 画面を、検証済みでソースマップに対応した表現にインポートし、ネイティブの SwiftUI を生成します。既存の Xcode およびシミュレーターのツールを再利用します。サポートされていないマークアップは報告され、生成はブロックされます。これはあらゆるフレームワークを変換するものではなく、npm 2.10.2 には含まれていません。アーキテクチャとロードマップおよび実際のネイティブプロトタイプの証拠を参照してください。

静的な React サブセットや保存済みエビデンスのレビューを含む、実験的なネイティブ変換の取り組みについては、Universal App Engine のアーキテクチャに記載されています。これらのプロトタイプは、React／Next.js への一般的な対応や、許容可能なビジュアル忠実度を実証するものではありません。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。