capacitor-mcp について
capacitor-mcpは、Capacitorのドキュメント、プラグイン一覧、IonicブログをAIアシスタントに提供する非公式MCPサーバーです。v8、v7、v6、nextに対応し、ホスト済みエンドポイントまたはnpxプロキシから利用できます。
主な機能
- 01Capacitorドキュメントの検索と閲覧
- 02v8、v7、v6、nextの指定
- 03公式・コミュニティ製プラグインの一覧
- 04Ionicブログ記事の一覧
- 05HTTPエンドポイントとnpxプロキシ
活用シーン
- 01Capacitor APIやCLIフラグの確認
- 02バージョン別ドキュメントの参照
- 03利用可能なCapacitorプラグインの検索
- 04Ionicブログ記事の取得
MCP 対応
MCPサーバーは、ドキュメント検索・閲覧、プラグイン一覧、ブログ記事検索のツールを提供します。クライアントはホスト済みHTTPエンドポイントに接続でき、リモートHTTP非対応の場合はnpxプロキシを利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://capacitor-mcp.capawesome.io/mcpclaude mcp add --transport http io-capawesome-capacitor https://capacitor-mcp.capawesome.io/mcp{"mcpServers":{"io-capawesome-capacitor":{"type":"http","url":"https://capacitor-mcp.capawesome.io/mcp"}}}Cursor で開く{"servers":{"io-capawesome-capacitor":{"type":"http","url":"https://capacitor-mcp.capawesome.io/mcp"}}}VS Code で開く{"mcpServers":{"io-capawesome-capacitor":{"type":"http","url":"https://capacitor-mcp.capawesome.io/mcp"}}}{"mcpServers":{"io-capawesome-capacitor":{"serverUrl":"https://capacitor-mcp.capawesome.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
4| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | integer | いいえ | 返す項目の最大数です(例:5)。デフォルトは 10、最大値は 25 です。 |
| query | string | はい | 検索語です(例:"camera permissions android"、"live reload")。通常のキーワードが最適です。検索演算子はサポートされていません。 |
| section | enum | いいえ | ドキュメントの一部に検索範囲を限定します(例:公式プラグインリファレンスの "apis"、ネイティブ iOS ガイドの "ios")。デフォルトではすべてのセクションを検索します。getting-started | basics | guides | android | ios | web | plugins | apis | cli | reference | updating | cordova |
| version | enum | いいえ | 任意です。Capacitor ドキュメントのバージョンです。デフォルトは v8 です。ユーザーの package.json にある @capacitor/core のメジャーバージョンに合わせてください。v8 | v7 | v6 | next |
詳細
Capacitor MCP サーバー
公式のCapacitorドキュメントを対象とした、非公式の MCP サーバーです。Capacitor v8、v7、v6、next の最新ドキュメント、公式およびコミュニティのプラグイン一覧、Ionic ブログの Capacitor に関する記事を AI アシスタントに提供するため、プラグイン API や CLI フラグについて推測する必要がなくなります。Ionic または OutSystems とは提携しておらず、承認も受けていません。
Capawesome がメンテナンスしています。
エンドポイント
サーバーはホスト済みで、すぐに利用できます。アカウント、トークン、インストールは不要です。
https://capacitor-mcp.capawesome.io/mcp
インストール
Claude Code
claude mcp add --transport http capacitor https://capacitor-mcp.capawesome.io/mcp
Claude Desktop / Claude.ai
Settings → Connectors → Add custom connector に移動して、次の内容を入力します。
- 名前:
Capacitor - URL:
https://capacitor-mcp.capawesome.io/mcp
Cursor
または、プロジェクトに .cursor/mcp.json を追加します。
{
"mcpServers": {
"capacitor": {
"url": "https://capacitor-mcp.capawesome.io/mcp"
}
}
}
VS Code
または、プロジェクトに .vscode/mcp.json を追加します。
{
"servers": {
"capacitor": {
"type": "http",
"url": "https://capacitor-mcp.capawesome.io/mcp"
}
}
}
Windsurf
サーバーを ~/.codeium/windsurf/mcp_config.json に追加します。
{
"mcpServers": {
"capacitor": {
"serverUrl": "https://capacitor-mcp.capawesome.io/mcp"
}
}
}
Zed
サーバーを Zed の settings.json に追加します。
{
"context_servers": {
"capacitor": {
"url": "https://capacitor-mcp.capawesome.io/mcp"
}
}
}
npx 経由で任意のクライアントから利用
HTTP 経由でリモートサーバーに接続できないクライアントでは、このパッケージを実行できます。stdio をホスト済みサーバーにプロキシします。
{
"mcpServers": {
"capacitor": {
"command": "npx",
"args": ["-y", "@capawesome/capacitor-mcp"]
}
}
}
Node.js 22 以降が必要です。
ツール
| ツール | 用途 | パラメーター |
|---|---|---|
search_docs | キーワードでドキュメントを検索します。Capacitor に関する質問は、まずこちらから始めてください。 | query(必須)、section、version、limit |
get_doc_page | search_docs が返したドキュメントページ全体を読み込みます。 | url(必須)、version |
list_plugins | 公式およびコミュニティの Capacitor プラグインを一覧表示します。 | query、source、limit |
list_blog_posts | Ionic ブログの最近の Capacitor 関連記事を一覧表示します。 | — |
バージョン
ドキュメントは Capacitor v8(デフォルト)、v7、v6、next で利用できます。特定のバージョンを指定するには、search_docs と get_doc_page に version パラメーターを渡します。
レート制限
エンドポイントは IP アドレスごとに毎分 100 件に制限されています。上限を超えたリクエストには 429 Too Many Requests が返されます。しばらく待ってから再試行してください。
プライバシー
IP アドレスはレート制限のためだけに処理されます。クエリとツールの引数は保存されず、Cloudflare の標準的なエッジログを超えて記録されることも、トレーニングに使用されることもありません。詳細はプライバシーポリシーをご覧ください。
関連項目
- Ionic Framework MCP Server — Ionic Framework のドキュメント、コンポーネント、使用例に対応した同様のサーバーです。
- Capawesome MCP Server — Capawesome のドキュメントと Capawesome Cloud 管理 API に対応する公式 MCP サーバーです。
- Capawesome Cloud Live Updates — アプリストアの審査を経ずに、JavaScript、HTML、CSS の変更をアプリに配信できます。
- Capawesome Cloud Native Builds — Mac を使わずに、クラウド上でネイティブ iOS アプリと Android アプリをビルドできます。
- Capawesome Cloud App Store Publishing — ビルドを Apple App Store と Google Play Store に申請できます。
帰属表示
ドキュメントの内容は Ionic チームの著作物であり、Apache-2.0 ライセンスの下で提供されています。また、ionic-team/capacitor-docs から取得しています。MCP 経由で提供するために MDX から Markdown に変換していますが、内容はそれ以外変更していません。コミュニティプラグインの一覧は capawesome-team/awesome-capacitorjs に由来します。ブログの抜粋はIonic ブログから取得し、元の記事にリンクしています。
詳しい帰属表示については、NOTICE をご覧ください。
開発
npm install
npm run build
npm test
ホストされているサーバーの代わりにローカルサーバーをプロキシの接続先にするには、CAPACITOR_MCP_URL を設定します。
CAPACITOR_MCP_URL=http://localhost:8787/mcp node dist/index.js
リリース
リリースは release-please で管理されています。リリース用プルリクエストをマージすると、バージョンにタグが付けられ、パッケージが npm に公開された後、server.json が MCP Registry に公開されます。server.json のバージョンは package.json とともに release-please によって更新されるため、手動で編集する必要はありません。レジストリに手動で公開するには、mcp-publisher をインストールし、パスワードマネージャーに保存された Ed25519 秘密鍵を使って mcp-publisher login dns --domain=capawesome.io --private-key=<key> を実行してから、mcp-publisher publish を実行します。
ライセンス
LICENSE をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。