Gemmein

gemmein

Gemmein CLI の配布元です。npm の gemmein パッケージと、実行されるローカルエンジンのリリース記録を提供しています。

Gemmein は、AI が構築したアプリのための信頼できるバックエンドです。アカウント、データ、決済を、アプリのコードではなくプラットフォームが境界を適用して保護します。CLI を使えば、それをお使いのマシンで利用できます。npx gemmein init では、平易な言葉でプロダクトの境界を定義でき、gemmein dev では、開発中にその境界を適用する本物のローカルバックエンドを実行できます。

MCP サーバー

@gemmein/mcp は、コーディングエージェントに Gemmein の契約全体をツールとして提供します。ビルダーガイド、SDK リファレンス、ルールとエラーの解説、アプリのアクセス境界のライブチェックが含まれます。8 つのツールは読み取り専用です。check_integration はアプリに対してライブチェックを実行します。開発用シークレットキーを指定すると、開発環境への書き込みも行います。テスト用のユーザーを 2 人作成し、プローブ用レコードを作成して削除し、テスト用ユーザーを以前のセッションからサインアウトします。

Claude Code へのインストール：

claude mcp add gemmein -- npx -y @gemmein/mcp

Claude Desktop、Cursor、または mcpServers ブロックに対応する任意のクライアントへのインストール：

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

実行に必要な環境変数はありません。

提供するツール：

• guide — 認証フロー、7 つの安全ルール、レコードの形状、リンク、アップロード、競合、決済に関するビルダーガイドの全文に加え、docs.gemmein.com/llms-dashboard.txt からライブで読み込むダッシュボードの手順も提供します。
• reference — すべての SDK メソッド、正確なシグネチャ、戻り値の形状、エラーコードを提供します。
• search_docs — 必要な情報を 1 つだけ探す場合に、両方を対象に絞り込んで検索します。
• explain_rule — 任意のルールの契約内容、適した用途、避けるべき間違いを説明します。また、計画段階で使える 7 つすべてのルールのチートシートも提供します。
• explain_error — GemmeinError コードの意味と、具体的な対処方法を説明します。
• validate_collection_name — 読み取りを開始するたびに結果が空になる前に、コレクション名の誤りを検出します。
• explain_relay — gemmein/relays/<name>.json の定義を入力すると、ダッシュボードに表示される文、または拒否時にフィールド名を示すメッセージを返します。オフラインで、write_record、grant_access、revoke_access、grant_credits、email_person、call_url、fulfil_product、refund_product、grant_plan、revoke_plan、start_run の 11 個の動詞に対応します。
• reaffirm_template — そのままコピーして使える CI ハーネスです。
• check_integration — アプリ自身を対象に、分離とアクセスのチェックをライブで実行し、合否を構造化して返します。

サーバーのソースコード全体は mcp/ にあります（MIT）。単独で動作する Node パッケージです。cd mcp && npm install && npm run build を実行してから、node dist/index.js を実行してください。Gemmein エンジンは使用しません。

ドキュメント：docs.gemmein.com/mcp。

Claude プラグイン

plugins/gemmein/ は、上記の MCP サーバーを正確なバージョンに固定してバンドルした Claude プラグインです。build-on-gemmein という 1 つのスキルが含まれています。このスキルは Claude に Gemmein ガイドを読ませ、アプリの目的を尋ね、Gemmein が適しているかどうかを伝えたうえで、最初の 1 時間の手順（npx -y gemmein dev、コレクション、npx gemmein sync、本番公開）に従わせます。このリポジトリはプラグインマーケットプレイスでもあります。Claude Code では次のようにします。

/plugin marketplace add gemmeinhq/gemmein-release
/plugin install gemmein@gemmein

プラグインの実行内容、送信内容、保存内容については、plugins/gemmein/README.md をご覧ください。

ランチャーの仕組み

インストールする npm パッケージは小さなランチャーで、読みやすいソースコードとして公開されています。shim/ にあるものが、そのままお使いのマシンで実行されます。

初回の実行時に Gemmein エンジンをダウンロードし、このパッケージ内に固定された SHA-256 ハッシュと照合して検証したうえで、ローカルにキャッシュして実行します。このダウンロードが完了すれば、以降はすべて完全にオフラインで動作します。ダウンロードしたファイルの検証に失敗した場合、ランチャーは実行を拒否します。

• shim/ — gemmein npm パッケージ（プレーンな JS。ビルド手順は不要）
• manifest/releases.json — すべてのエンジンリリースとそのファイルハッシュ

ライセンス

意図的に、2つのライセンスを採用しています。

• MCP サーバー（mcp/、@gemmein/mcp として公開）は MIT です。
• npm ランチャー（shim/）は MIT です。読んで、監査して、ご自由にお使いください。
• ダウンロードしたエンジンは、Gemmein Engine License に基づくプロプライエタリなものです。Gemmein を使った開発のために、自由に実行・キャッシュできます（キャッシュ後は、バージョンの提供が終了した場合でもオフラインで利用できます）が、再配布や抽出はできません。また、downloads.gemmein.com/engine/LICENSE でも公開されています。

使用方法

npx gemmein init

ドキュメント：docs.gemmein.com · ご質問： [email protected]