Mantis Immersive Commerce MCP

Mantis MCP Server

既存の eコマースカタログを活用して、コンバージョン率の高い没入型コマースショールームを構築するための AI アシスタントツールです。New Balance をはじめとする Fortune 500 企業が利用し、パリ 2024 オリンピック、MLB、NHL、プレミアリーグで導入されている、Mantis の本番環境向け没入型コマースプラットフォームを基盤としています。

Mantis が目指す、エージェントから呼び出せる没入型コマースインフラストラクチャの一環です。詳しくは mantisxr.com をご覧ください。

クイックスタート

npx mantis-mcp

または、グローバルにインストールします。

npm install -g mantis-mcp

その後、Claude Desktop、Cursor、または MCP 対応のクライアントで設定します（下記の設定を参照）。

ステータス

この MCP が接続する Mantis ショールームプラットフォームは本番環境で稼働しており、New Balance をはじめとする Fortune 500 企業が利用しています。パリ 2024 オリンピック、シカゴ・カブス（MLB）、セントルイス・ブルース（NHL）、バーンリー FC などのプレミアリーグクラブで導入されています。この MCP サーバーによって、プラットフォームが AI エージェントから利用できるようになります。現在も積極的に開発中です。一部のツールは現時点で実際のプラットフォーム API に完全に接続されていますが、バックエンドのエンドポイントを構築中のため、シミュレーションを使用しているツールもあります。何が実装済みで、何が開発中なのかは、以下のツールのステータスをご確認ください。

セットアップ

環境変数（任意）

実際の Mantis API に接続するには、以下を設定します。

MANTIS_API_URL=https://your-mantis-instance.com
MANTIS_AUTH_TOKEN=your_token_here

Mantis のユーザーは、アカウントのセットアップ時に API URL と認証トークンを受け取ります。これらを設定しなくても、ツールはコード生成と計画にシミュレーションデータを使用して動作します。

設定

Claude Desktop：

1. Settings → Developer → Edit Config を開きます
2. 以下を追加します。

{
  "mcpServers": {
    "mantis-mcp": {
      "command": "npx",
      "args": ["mantis-mcp"]
    }
  }
}

Cursor：

1. Settings → MCP Servers → Add new server を選択します
2. npx mantis-mcp を指定して設定します

その他の MCP クライアント： npx mantis-mcp または node /path/to/dist/index.js を使用します。

ツール

✅ 正常に動作（API 不要）

installMantisSDK Mantis SDK を React、Vue、Next.js、Shopify、またはバニラ JavaScript プロジェクトに統合するための、インストールコマンドと .npmrc の設定を生成します。

createMantisIntegration イベントハンドラー、カート連携、アナリティクスのトラッキングを含む、フレームワークに応じた完全な統合コードを生成します。

generateEventHandler Mantis SDK のイベント（cart-opened、model-click、variant-changed など）向けのイベントハンドラーコードを作成します。

analyzeConsoleErrors よくあるエラー（SDK が読み込まれない、postMessage がブロックされる、WebGL の問題など）をパターンマッチングで特定し、コード例とともに修正方法を提示します。

checkBrowserCompatibility WebGL、postMessage、全画面表示、その他の没入型機能についてブラウザーとの互換性を確認し、ポリフィルを推奨します。

🟡 一部動作（設定済みの場合は実際の API を使用）

validateSetup Mantis SDK のインストールを検証します。MANTIS_API_URL が設定されている場合は実際の showrooms.getShowroom API を呼び出し、設定されていない場合は検証チェックのサンプルを返します。

importCatalog Shopify（実際の API）、CSV、または手動入力から商品カタログをインポートします。データの解析は正常に完了しますが、バックエンドの保存エンドポイントは未実装です。

createStore 没入型ショールームを作成します。API が設定されている場合は実際の showrooms.createShowroom API 呼び出しを試み、失敗した場合はガイダンス付きのモック応答に切り替えます。

publishStore ショールームを公開します。設定されている場合は実際の showrooms.updateShowroom API を呼び出し、そうでない場合はステータスの変更をアクティブ状態への切り替えとしてシミュレーションします。

🔴 モック（シミュレーションデータを使用、バックエンドのエンドポイントは未実装）

debugPostMessage 現実的なメッセージのタイムライン、オリジンのチェック、エラーパターンを使って、postMessage のデバッグシナリオをシミュレーションします。

testMantisEvent 検証とパフォーマンス計測を含め、SDK イベント（model-loaded、add-to-cart など）のテストをシミュレーションします。

simulateUserFlow 現実的な遅延やエラーシナリオを交えながら、複数ステップのユーザー操作フロー（読み込み → クリック → カートに追加）をシミュレーションします。

getPerformanceMetrics 要求されたメトリクスに基づいて、パフォーマンスデータ（FPS、読み込み時間、メモリ、GPU）をシミュレーションして生成します。

analyzeEventFlow コンバージョンファネル、離脱ポイント、ユーザー行動パターンを含むイベントフロー分析をシミュレーションします。

この MCP が行わないこと

没入型アセットの生成： Mantis は、商品写真を没入型体験に対応したアセットへ自動変換する機能を提供しません。加盟店は、商品を作成する際に、没入型体験に対応したアセット（.glb/.gltf ファイル）を用意する必要があります。これは意図的なスコープの決定です。アセットの自動生成はコモディティ化が進むサービスレイヤーであり、持続可能な事業を築けないまま、複数の企業が参入してきました。Mantis の価値は、没入型ショールームプラットフォーム、マーチャンダイジングインテリジェンス、エージェントから呼び出せるコマース基盤にあり、アセット生成にはありません。

開発

# Clone and install
git clone https://github.com/kahlilashanti/mantis-mcp.git
cd mantis-mcp
npm install

# Build
npm run build

# Run locally
npm start

ライセンス

MIT

リンク

• Mantis プラットフォーム
• GitHub の課題
• Model Context Protocol