ionic-framework-mcp

Ionic Framework MCP サーバー

公式の Ionic Framework ドキュメント向けの非公式 MCP サーバーです。Ionic Framework v9 および v8 の最新ドキュメントを AI アシスタントに提供します。コンポーネント API リファレンスや、Angular、React、Vue、vanilla JavaScript の使用例に加え、Ionic ブログも利用できます。Ionic または OutSystems とは提携も推奨関係もありません。

Capawesome がメンテナンスしています。

エンドポイント

サーバーはホストされており、すぐに使用できます。アカウント、トークン、インストールは不要です。

https://ionic-framework-mcp.capawesome.io/mcp

インストール

Claude Code

claude mcp add --transport http ionic-framework https://ionic-framework-mcp.capawesome.io/mcp

Claude Desktop / Claude.ai

Settings → Connectors → Add custom connector に移動し、次の情報を入力します。

• Name：Ionic Framework
• URL：https://ionic-framework-mcp.capawesome.io/mcp

Cursor

または、プロジェクトに .cursor/mcp.json を追加します。

{
  "mcpServers": {
    "ionic-framework": {
      "url": "https://ionic-framework-mcp.capawesome.io/mcp"
    }
  }
}

VS Code

VS Code にインストール

または、プロジェクトに .vscode/mcp.json を追加します。

{
  "servers": {
    "ionic-framework": {
      "type": "http",
      "url": "https://ionic-framework-mcp.capawesome.io/mcp"
    }
  }
}

Windsurf

サーバーを ~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "ionic-framework": {
      "serverUrl": "https://ionic-framework-mcp.capawesome.io/mcp"
    }
  }
}

Zed

サーバーを Zed の settings.json に追加します。

{
  "context_servers": {
    "ionic-framework": {
      "url": "https://ionic-framework-mcp.capawesome.io/mcp"
    }
  }
}

npx を使う任意のクライアント

HTTP 経由でリモートサーバーに接続できないクライアントは、このパッケージを実行して stdio をホストサーバーにプロキシできます。

{
  "mcpServers": {
    "ionic-framework": {
      "command": "npx",
      "args": ["-y", "@capawesome/ionic-framework-mcp"]
    }
  }
}

Node.js 22 以降が必要です。

ツール

ツール	目的	パラメーター
search_docs	キーワードでドキュメントを検索します。Ionic Framework に関する質問は、ここから始めてください。	query（必須）、section、version、limit
get_doc_page	search_docs が返したドキュメントページ全体を読み取ります。	url（必須）、version
list_components	API リファレンス付きで Ionic Framework のコンポーネントを一覧表示します。	query、version、limit
get_component_usage	フレームワークごとのコンポーネント使用例を読み取ります。	component（必須）、example、framework、version
list_blog_posts	Ionic ブログの最近の記事を一覧表示します。	—

バージョン

ドキュメントは Ionic Framework v9（デフォルト）および v8 で利用できます。特定のバージョンを指定するには、version パラメーターを渡してください。

レート制限

エンドポイントには、IP ごとに 1 分あたり 100 リクエスト の制限があります。制限を超えたリクエストには 429 Too Many Requests が返されます。少し待ってから再試行してください。

プライバシー

IP アドレスはレート制限のためだけに処理されます。クエリとツールの引数は保存されず、Cloudflare の標準エッジログを超えて記録されることもなく、トレーニングに使用されることもありません。詳しくはプライバシーポリシーをご覧ください。

関連

• Capacitor MCP Server — Capacitor のドキュメント、プラグイン一覧、ブログ向けの同様のサーバーです。
• 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/ionic-docs から取得しています。MCP 経由で配信するために MDX から Markdown に変換されていますが、内容は変更されずに提供されます。コンポーネント API リファレンスは @ionic/docs パッケージ（MIT）に由来します。ブログの抜粋は Ionic blog から取得しており、元の記事へのリンクを掲載しています。

帰属表示の詳細については、NOTICE をご覧ください。

開発

npm install
npm run build
npm test

ホストされたサーバーの代わりにローカルサーバーをプロキシの接続先にするには、IONIC_FRAMEWORK_MCP_URL を設定します。

IONIC_FRAMEWORK_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 をご覧ください。