MCPツールで支払いを受け付ける

このプロジェクトは、MCP（Model Context Protocol）サーバー向けのドロップインコマースコアであり、Agentic Commerce Protocol（ACP）上に構築されています。開発者は単純な製品ファイルを指定するだけで、MCPツールが進行中の会話内で直接支払いを受け付けられるようになります。例えば、アセットの購入、Proへのアップグレード、ライセンスの更新、クレジットの購入などが可能です。コマースロジックはクリーンなライブラリであり、MCPサーバーとACP RESTエンドポイントはその上の薄いレイヤーです。

このプロジェクトは、すでにMCPツールを運用している、または構築中の企業向けで、将来的にツール内で課金したい場合に適しています。コマースは実際のブランドと製品と共に動作するため、未知のストアフロントに対する信頼の問題は発生しません。なお、これは未知の販売者向けの独立したショッピング先ではなく、CRM、注文データベース、顧客履歴ストアでもなく、支払い成功後は注文を販売者に渡して忘れます。また、フロントエンドではなく、意図的にカートUIやチャットウィジェットは提供されていません。

プロジェクトは3つの使用モードを提供しています：スタンドアロンサーバー（npm start、Dockerイメージ、Lambdaハンドラを含むスタック全体を実行）、組み込み（コマースコアを独自のMCPサーバーにインポートしてツールを登録）、ライブラリのみ（REST APIやボットからコアを呼び出し、MCPは不要）。クイックスタートでは、Dockerを使用したスタンドアロンサーバーの実行例や、既存のMCPサーバーにコマースコアを埋め込むコード例を示しています。AWS Lambdaデプロイでは、DynamoDBストアとS3カタログソースを使用します。

製品ファイルはカタログのみを含み、注文や設定は混在しません。価格は整数の最小単位（セント）で表され、Stripeに合わせて浮動小数点の通貨バグを避けます。設定では、非機密設定はconfig.jsonに、機密情報は環境変数のみから取得します。ストレージとカタログドライバーは交換可能で、カタログ（読み取り専用）はバンドルファイル、リモートURL、S3オブジェクトから選択でき、カートとチェックアウトセッション（短期、TTL、顧客データではない）はSQLite（Docker/EC2）またはDynamoDB（Lambda、ネイティブTTL）を使用します。

支払いは、Stripeを直接統合（Stripeホスト型チェックアウトURLを提供）、または委任支払い（SPT、米国、Stripeプレビュー条件）をサポートします。税はStripe Taxに委任され、デフォルトではオフです。MCPツールには、製品の検索・取得、カートへの追加、カートの表示、カートアイテムの更新・削除、チェックアウトが含まれます。トランスポートはステートレスであるため、add_to_cartはcart_idを返し、後続の呼び出しで渡す必要があります。開発はnpm install、npm run dev、npm testなどのスクリプトで行います。ライセンスはElastic License 2.0で、自由に使用、変更、組み込みが可能ですが、第三者对ホスト型または管理型コマースサービスとして提供することはできません。