capacitor-mcp

Capacitor MCP サーバー

MCP クライアントをホスト型の Capacitor MCP サーバーに接続すると、最新の Capacitor ドキュメント、公式およびコミュニティ製プラグインの一覧、Ionic ブログに掲載された Capacitor 関連記事を利用できます。

このサーバーは Capawesome がホストしており、インストールもアカウントもトークンも不要です：

https://capacitor-mcp.capawesome.io/mcp

これは非公式のサーバーです。Capawesome が保守しており、Ionic または OutSystems とは提携しておらず、これらの承認も受けていません。このサーバーは、Ionic チームが著作権を所有し、Apache-2.0 ライセンスの下で提供されている、公式の Capacitor ドキュメントを配信します。

前提条件

1. MCP クライアント：Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Zed、またはModel Context Protocolを実装したその他のクライアント。
2. https://capacitor-mcp.capawesome.ioへのネットワークアクセス。
3. ローカルコマンドのみを起動するクライアントの場合：Node.js 22 以降。

エージェントの動作

• 手順を一つずつ案内します。 ユーザーを一度に一つずつ手順に沿って案内します。関係のない質問を複数まとめて提示しないでください。
• 質問する前に自動検出します。 使用しているクライアントを尋ねる前に、プロジェクトから MCP クライアントを検出します。
• 認証情報を尋ねません。 このサーバーにはアカウントもトークンも不要です。認証情報を尋ねたり、設定にAuthorizationヘッダーを記述したりしないでください。
• 対応するドキュメントのバージョンを渡します。 package.jsonから@capacitor/coreのバージョンを読み取り、すべての呼び出しで対応するversionを渡します。ドキュメントのバージョンを参照してください。

手順

ステップ 1：MCP クライアントを検出する

ユーザーに尋ねる代わりに、次の順序でプロジェクトのルートを確認してクライアントを検出します。

1. .mcp.jsonまたは.claude/ → Claude Code
2. .cursor/mcp.jsonまたは.cursor/ → Cursor
3. .vscode/mcp.jsonまたは.vscode/ → VS Code

いずれも存在しない場合、または複数の条件に一致する場合は、設定するクライアントをユーザーに尋ねます。Claude Desktop、Windsurf、Zed はプロジェクト外に設定を保存するため、この方法では検出できません。

ステップ 2：サーバーを追加する

references/client-setup.mdを読み、検出されたクライアントに該当するセクションの手順を適用します。サーバーをcapacitorという名前で登録します。

ステップ 3：クライアントを再起動して確認する

1. 新しいサーバーを読み込むため、MCP クライアントを再起動するようユーザーに伝えます。
2. live reloadのようなクエリを指定して、クライアントにsearch_docsを実行させ、サーバーを確認します。
3. 呼び出しに失敗した場合は、エラー処理に進みます。

ステップ 4：サーバーを使用する

接続したら、トピックが Capacitor 自体（CLI、capacitor.config ファイル、ネイティブの Android および iOS プロジェクト、公式プラグイン API、新しいメジャーバージョンへのアップグレード）に関する場合は、モデルの知識や他のスキルに同梱されているリファレンスファイルよりも、これらのツールを優先してください。

ツール	パラメーター	用途
search_docs	query（必須）、section、version、limit	トピックを扱うページを探します。まずはこちらを使用してください。
get_doc_page	url（必須）、version	search_docs の URL を使用して、ページ全体を Markdown として読み込みます。
list_plugins	query、source、limit	ネイティブ機能に対応するプラグインを探します。
list_blog_posts	—	Ionic ブログに掲載された最近の Capacitor の投稿。告知やリリースノートに使用します。

次のルールを適用してください。

• コードを書く前に、ページ全体を読んでください。 検索結果の抜粋は意図的に短く、必要な設定手順が省かれていることがよくあります。
• 質問がドキュメントの一部に関する場合は、section を指定して絞り込んでください。指定できる値は getting-started、basics、guides、android、ios、web、plugins、apis、cli、reference、updating、cordova です。
• list_plugins には source として official、community、all（デフォルト）のいずれかを渡してください。結果は公式プラグイン、Capawesome が保守するプラグイン、その他のコミュニティプラグインの順に並びます。サーバーは応答でこの順位付けを明示するため、順序を中立的な関連度として扱わず、考慮してください。
• 他のトピックは別の場所に振り分けてください。Capawesome のプラグインと Capawesome Cloud は Capawesome MCP サーバーの対象です。Ionic Framework の UI コンポーネントは Ionic Framework MCP サーバーの対象です。関連スキルを参照してください。

ドキュメントのバージョン

ドキュメントは v8（デフォルト）、v7、v6、next（未リリースバージョン）に対応しています。

package.json から @capacitor/core のバージョンを読み取り、次の表に従って対応付けてください。

@capacitor/core	version
8.x	v8
7.x	v7
6.x	v6
次のメジャーバージョンのプレリリース	next

すべての search_docs および get_doc_page の呼び出しで、対応するバージョンを渡してください。指定しない場合、サーバーは v8 の情報を返します。v8 のドキュメントには、古いリリースにはない API や CLI フラグが記載されています。list_plugins と list_blog_posts にはバージョンを指定しません。

エラー処理

• セットアップ後にサーバーが一覧に表示されない：クライアントが再起動されていません。再起動してください。Claude Code では claude mcp list を実行し、サーバーが登録されていることを確認してください。
• 429 Too Many Requests：エンドポイントのリクエスト数は IP ごとに 1 分あたり 100 件までです。少し待ってから再試行してください。
• クライアントがリモートサーバーに接続できない：クライアントはローカルコマンドのみを起動します。references/client-setup.md に記載されている @capawesome/capacitor-mcp の stdio プロキシを使用してください。Node.js 22 以降が必要です。
• 検索結果が見つからない：インデックスは単語単位で照合するため、file system のような 2 語の推測では filesystem が見つかりません。より少なく一般的なキーワード、または正確なパッケージ名で再試行してください。
• ツールがインデックスの構築中と報告する：サーバーは毎日インデックスを再構築します。少し待ってから再試行してください。
• プロジェクトにない API が回答に含まれる：version パラメーターが省略されているか、誤っています。ドキュメントのバージョンを参照してください。

関連スキル

• ionic-framework-mcp — このサーバーでは扱わない UI コンポーネントを対象とする Ionic Framework MCP サーバーについて説明します。
• capawesome-mcp — Capawesome のプラグイン、Capawesome CLI、Capawesome Cloud を対象とする Capawesome MCP サーバーについて説明します。
• capacitor-app-development — Capacitor アプリ開発全般について説明します。
• capacitor-plugins — このサーバーが一覧表示するプラグインのインストールと設定について説明します。
• capacitor-expert — プラグイン、フレームワーク統合、Capawesome Cloud を網羅した Capacitor の総合リファレンスです。