GMC Builder MCP Lite

GMC Builder MCP Lite

GMC Pro 製品の無料・機能限定版コンパニオンです。これは、履歴を新たに作成し、読み取り専用の MCP ツールを 4 つだけ備えた別個の 0.1.3 クライアントです。Pro の実装はこのリポジトリには含まれていません。

Lite と Pro

機能	Lite	Pro 製品
設定済みのサイトエイリアス	はい	はい
認証済み接続のプローブ	はい	はい
1 回の呼び出しにつき最大 10 個の要素タイプ	はい	拡張ツール
ローカルで指定した JSON：ノード数／タイプ	はい、入力は最大 64 KiB	詳細な検査
レイアウトまたはドキュメントの作成／編集／公開	いいえ	有料機能
完全なエクスポート／インポート、一括編集、バックアップ	いいえ	有料機能
非公開の Pro 実装または CMS コンパニオンのソース	含まれていません	別途配布

Pro の機能と現在の年間プランをご覧ください。コンパニオンの要件や製品に関するお問い合わせは、[email protected] までご連絡ください。

Lite は限定的な商用ライセンスのもとで無料でご利用いただけます。 ソースを閲覧できることは、再配布または転売の権利を付与するものではありません。

MCP クライアントで Pro にアップグレードする

リソース Pro にアップグレード（gmc://lite/pro-features）を開くと、機能の比較と製品の現在のプランを確認できます。編集、公開、完全なインポート／エクスポート、一括編集、復元には Lite では利用できません と表示されています。これらは情報を提供するためのプレビューであり、Pro のコードや実行可能な Pro ツールはバンドルされていません。無料ツールはアップグレードなしで引き続き動作します。

リソースの表示方法は MCP クライアントによって異なるため、ポップアップやグラフィカルな設定パネルが必ず表示されるとは限りません。クライアントにリソースブラウザーがない場合は、アシスタントにリソースを読むよう依頼してください。

ガイドと紹介資料

• Lite 実践ガイド（英語）：前提条件、セットアップ、最初の読み取り専用セッションについて説明します。
• クライアント向け紹介資料（イタリア語 PDF）：3 種類の Lite クライアントと、別途提供される Pro エディションの概要です。
• Pro の機能と年間プラン。

前提条件

Python 3.10 以降。対象サイトに GMC Builder がインストールされている必要があります。Application Password を使用する WordPress 作成 API（2.0.0 以降）、または共有の X-Gmc-Builder-Key を使用する Joomla リモート API（2.0.1 以降）が必要です。このリポジトリでは GMC Builder を配布していません。CMS 製品は GMC から入手してください。Lite にはレイアウトエクスポートエンドポイントは含まれていません。

GitHub からインストールする

git clone https://github.com/gmcfuerte/gmcbuilder-mcp-lite.git
cd gmcbuilder-mcp-lite
python -m venv .venv

Windows：

.venv\Scripts\python.exe -m pip install .

macOS/Linux：

.venv/bin/python -m pip install .

この Lite エディションはこの GitHub リポジトリを通じて配布されており、 PyPI には公開されていません。Lite の代わりに、別途提供されている完全版 Pro パッケージを インストールしないでください。

設定

1. sites.example.json をローカルの sites.json にコピーし、自分が所有するサイト、またはアクセスを許可されているサイトだけを残します。このファイルは Git の対象外です。
2. username_env、password_env、および該当する Joomla のトークン／キーのフィールドで指定された環境変数に認証情報を設定します。コミットする JSON や MCP のチャットに認証情報を記載しないでください。
3. GMCBUILDER_MCP_LITE_SITES に、そのローカル JSON ファイルの絶対パスを設定します。
4. mcp.example.json を使ってサーバーを追加し、プレースホルダーを Python 実行ファイルと設定ファイルの絶対パスに置き換えます。MCP クライアントが認証情報の環境変数を子プロセスに渡すことを確認してください。
5. まず gmcbuilder_lite_list_sites を実行し、次に gmcbuilder_lite_ping_site を実行します。

rest_mode: "query" は、REST URL のパーマリンク設定がない WordPress に対応します。それ以外の場合は pretty を使用してください。サブディレクトリへのインストールはベース URL でサポートされています。

ツール

• gmcbuilder_lite_list_sites：エイリアスとプラットフォームのみを返します。
• gmcbuilder_lite_ping_site：認証済みの GET を 1 回実行し、サニタイズ済みのステータスのみを返します。
• gmcbuilder_lite_list_element_types：ビルダーの要素タイプ名を最大 10 件返します。スキーマやキットのエクスポートは行いません。
• gmcbuilder_lite_summarize_layout：layout.example.json のテキストを layout_json として渡します。設定やコンテンツは含まず、件数とタイプを返します。

サーバーはローカルで stdio を使用して実行されます。リモート HTTP サーバー、アップロード、任意の URL、SSH、ライセンス切り替え、Pro モジュールは含まれません。オンラインツールでは、固定の GET 許可リスト、検証済みの TLS、リダイレクトなし、設定済みのベース URL ごとに同時に 1 リクエストまで、2 秒の間隔、1 MiB のレスポンス上限が適用されます。HTTP は、完全一致するループバックホストに限り許可されます。HTTP 403／415 が発生すると、再起動するまでそのベース URL への後続リクエストは停止します。

リリース状況

Lite の初回リリースでは、ソースとパッケージの内容を検査し、Python のコンパイルを確認しました。サイトとの統合および実行時のテストは行っていません。この初回リリースを、本番環境への統合認証として扱わないでください。

お問い合わせ

GMC · [email protected]。 独立した GMC ソフトウェアです。製品名はそれぞれの所有者に帰属します。