mcp-amazon

Name: mcp-amazon
Author: codespar

ローカル

github.com/codesparビジネス・マーケティング2754 週間前に更新

リポジトリ

mcp-amazon について

mcp-amazon は Amazon Selling Partner API（SP-API）向けの MCP サーバーで、注文、出品、カタログ、在庫、財務データを扱います。Amazon BR、MX、US や EU/FE マーケットプレイスで販売するセラーを対象とし、リージョンとマーケットプレイスは環境変数で設定します。

主な機能

01注文と注文明細の参照
02出品アイテムの参照、作成、更新、削除
03識別子やキーワードによるカタログ検索
04FBA 在庫サマリーの取得
05照合用の財務イベント一覧
06レポート、フィード、通知サブスクリプションの管理

活用シーン

01注文と注文明細の確認
02SKU 単位での出品情報の一括管理
03注文ごとの返金や手数料の照合
04ASIN の販売手数料と FBA 手数料の見積もり

MCP 対応

本サーバーは注文、出品、カタログ、在庫、レポート、財務に対応する SP-API のエンドポイントを、24 のツールとして MCP クライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-amazon": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-amazon"
      ],
      "env": {
        "AMAZON_LWA_CLIENT_ID": "<AMAZON_LWA_CLIENT_ID>",
        "AMAZON_LWA_CLIENT_SECRET": "<AMAZON_LWA_CLIENT_SECRET>",
        "AMAZON_REFRESH_TOKEN": "<AMAZON_REFRESH_TOKEN>",
        "AMAZON_MARKETPLACE_ID": "<AMAZON_MARKETPLACE_ID>",
        "AMAZON_REGION": "<AMAZON_REGION>",
        "AMAZON_SELLER_ID": "<AMAZON_SELLER_ID>"
      }
    }
  }
}

起動コマンドnpx -y @codespar/mcp-amazon

設定が必要な環境変数

AMAZON_LWA_CLIENT_IDLogin with Amazon (LWA) client_id from Seller Central > Developer Central (SP-API app).

AMAZON_LWA_CLIENT_SECRETシークレットLWA client_secret paired with AMAZON_LWA_CLIENT_ID.

AMAZON_REFRESH_TOKENシークレットLong-lived seller-authorized refresh_token exchanged for 1-hour LWA access tokens used as x-amz-access-token.

AMAZON_MARKETPLACE_IDDefault marketplace id. BR: A2Q3Y263D00KWC, US: ATVPDKIKX0DER, MX: A1AM78C64UM0Y8, CA: A2EUQ1WTGCTBG2. Required by most endpoints; can be overridden per-call.

AMAZON_REGIONSP-API region: 'na' (default — Americas, incl. BR/US/MX/CA), 'eu' (Europe + India + MENA), 'fe' (Far East — JP/AU/SG).

AMAZON_SELLER_IDDefault sellerId (merchant token) used by Listings endpoints. Can be overridden per-call.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@codespar/mcp-amazon0.2.0-alpha.3stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
NextToken	string	いいえ	前回のレスポンスから取得したページネーショントークン。
BuyerEmail	string	いいえ
CreatedAfter	string	いいえ	ISO-8601 タイムスタンプ — この時刻以降に作成された注文のみ。
CreatedBefore	string	いいえ	ISO-8601 タイムスタンプ — この時刻以前に作成された注文のみ。
OrderStatuses	array	いいえ	ステータスで絞り込みます：PendingAvailability、Pending、Unshipped、PartiallyShipped、Shipped、Canceled、Unfulfillable、InvoiceUnconfirmed。
SellerOrderId	string	いいえ
MarketplaceIds	array	いいえ	マーケットプレイス ID（カンマ区切り）。デフォルトは AMAZON_MARKETPLACE_ID env です。BR：A2Q3Y263D00KWC、US：ATVPDKIKX0DER、MX：A1AM78C64UM0Y8。
PaymentMethods	array	いいえ	COD、CVS、Other。
LastUpdatedAfter	string	いいえ	ISO-8601 タイムスタンプ — この時刻以降に更新された注文のみ。
LastUpdatedBefore	string	いいえ	ISO-8601 タイムスタンプ — この時刻以前に更新された注文のみ。
MaxResultsPerPage	number	いいえ	ページサイズ（1-100）。デフォルトは 100 です。
FulfillmentChannels	array	いいえ	AFN（FBA）または MFN（出品者出荷）。

詳細

@codespar/mcp-amazon

Amazon Selling Partner API（SP-API）向けのMCP サーバーです。Amazon BR、Amazon MX、Amazon US、およびすべてのEU/FEマーケットプレイスを含む、世界最大のマーケットプレイスです。

LatAmの出品者にとって、Amazonはこのカタログにすでに掲載されているマーケットプレイス3社を補完します。

Mercado Libre（@codespar/mcp-mercadolibre）— LatAm全般（BR、AR、MX、CO、CL）で圧倒的なシェアを誇ります。
Shopee（@codespar/mcp-shopee）— ブラジルで強く、地域全体でも急速に成長しています。
Amazon（このパッケージ）— 世界中に展開しているほか、LatAmの出品者向けのAmazon BR/MX、およびAmazon US/EU/JPへの越境販売にも対応します。

この3社を組み合わせることで、LatAmの事業者が有意なGMVを取引するほぼすべてのマーケットプレイスをカバーできます。

ツール（24）

ツール	目的
`list_orders`	Amazon SP-APIから注文を一覧表示します。
`get_order`	AmazonOrderIdで注文を1件取得します（例：
`get_order_items`	AmazonOrderIdで注文の明細項目を取得します。
`get_listings_item`	SKUで出品者の出品商品を1件取得します。
`put_listings_item`	SKUで出品者の出品商品を作成するか、完全に置き換えます。
`delete_listings_item`	SKUで出品者の出品商品を削除します。
`search_catalog_items`	識別子またはキーワードでAmazonカタログを検索し、参照用の商品データ（ASIN、タイトル、ブランド、画像）を取得します。
`get_inventory_summary`	FBA在庫の概要（出荷可能、入荷中、予約済み、調査中、出荷不可の数量）を取得します（...
`create_report`	SP-APIレポートをリクエストします。
`get_report`	レポートのステータスを取得します。ステータスがDONEの場合はreportDocumentIdも取得でき、Reportsドキュ...からフェッチできます。
`list_financial_events`	照合のため、出荷、返金、サービス手数料、調整などの財務イベントを一覧表示します。
`get_order_shipment_status`	Shipping API（Amazon Shipping / Buy Shippingのラベル）を使用して、shipment idの配送状況を取得します。
`create_subscription`	指定したnotificationTypeのNotifications APIサブスクリプションを作成します（SP-APIイベントのWebhook相当...
`patch_listings_item`	JSON Patch操作のリストを使用して、SKUで出品者の出品商品を部分的に更新します。
`confirm_shipment`	注文の商品を出荷済みとして確定します（Orders API v0）。
`update_shipment_status`	注文の配送状況を更新します（Orders API v0）。
`list_reports`	出品者がリクエストしたレポートを一覧表示します。
`cancel_report`	IN_QUEUEで、まだ処理が開始されていないレポートをキャンセルします。
`create_feed`	SP-APIにフィードを送信します（例：
`get_feed`	フィードのステータスを取得します。ステータスがDONEの場合はresultFeedDocumentIdも取得でき、結果はFeed Document API...からフェッチできます。
`list_financial_events_by_order`	1件の注文に限定して、出荷、返金、サービス手数料、調整などの財務イベントを一覧表示します。
`get_my_fees_estimate_for_asin`	指定価格でASINを販売する場合の販売手数料とFBA手数料を見積もります。
`list_subscriptions`	notificationTypeの現在のサブスクリプションを取得します（アプリごとにnotificationTypeあたり1つのサブスクリプション）。
`get_marketplace_participations`	出品者が販売登録しているすべてのマーケットプレイスを一覧表示します（Sellers API）。

インストール

npm install @codespar/mcp-amazon@alpha

環境変数

AMAZON_LWA_CLIENT_ID="amzn1.application-oa2-client....."
AMAZON_LWA_CLIENT_SECRET="..."
AMAZON_REFRESH_TOKEN="Atzr|..."          # long-lived, seller-authorized
AMAZON_MARKETPLACE_ID="A2Q3Y263D00KWC"   # BR; ATVPDKIKX0DER=US, A1AM78C64UM0Y8=MX
AMAZON_REGION="na"                        # na | eu | fe (default na)
AMAZON_SELLER_ID="A3..."                  # optional; default for Listings tools

マーケットプレイスID（よく使われるもの）

マーケットプレイス	ID	リージョン
ブラジル	`A2Q3Y263D00KWC`	na
アメリカ合衆国	`ATVPDKIKX0DER`	na
メキシコ	`A1AM78C64UM0Y8`	na
カナダ	`A2EUQ1WTGCTBG2`	na
スペイン	`A1RKKUPIHCS9HS`	eu
イギリス	`A1F83G8C2ARO7P`	eu
ドイツ	`A1PA6795UKMFR9`	eu
日本	`A1VC38T7YXB528`	fe

認証

SP-API では、2 段階の Login with Amazon（LWA）フローを使用します。

リフレッシュトークンをアクセストークンに交換（有効期間は 1 時間）。サーバーは https://api.amazon.com/auth/o2/token に grant_type=refresh_token と client_id／client_secret／refresh_token を指定して POST します。結果は有効期限のおよそ 1 分前までメモリ内にキャッシュされます。
地域別のベース URL と、x-amz-access-token: <token> および Content-Type: application/json ヘッダーを使用して SP-API を呼び出します。

AWS Signature v4 によるリクエスト署名は、以前は SP-API の必須要件でした。Amazon は 2023 年にほとんどのテナントで SigV4 の要件を撤廃したため、このサーバーでは LWA のみで認証します。出品者が現在も SigV4 を必要とする設定になっている場合は、amazonRequest を署名ツール（@aws-sdk/signature-v4）でラップする必要があります。これはここには含まれていません。

地域別ベース URL

NA（ブラジル、米国、メキシコ、カナダを含む南北アメリカ）：https://sellingpartnerapi-na.amazon.com
EU（ヨーロッパ、インド、中東・北アフリカ）：https://sellingpartnerapi-eu.amazon.com
FE（極東 — 日本、オーストラリア、シンガポール）：https://sellingpartnerapi-fe.amazon.com

AMAZON_REGION で選択します。ブラジルと南北アメリカには na を使用します。

実行

# stdio (default — Claude Desktop, Cursor, etc)
npx @codespar/mcp-amazon

# HTTP (server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-amazon

通知

create_subscription は、SP-API における Webhook 相当の機能です。Amazon は HTTP Webhook を直接プッシュしません。代わりに、まず POST /notifications/v1/destinations を使って宛先（SQS キューまたは EventBridge バス）を作成し、その宛先にサブスクリプションを追加します。このパッケージではサブスクリプションの作成に対応しています。宛先のプロビジョニングは一度だけ行う設定で、通常は AWS コンソールまたはデプロイスクリプトから実施します。

ステータス

0.1.0-alpha.1 — SP-API には 30 を超える商品セクションがあり、このパッケージでは商取引に関連するサブセット（注文、出品、カタログ、在庫、レポート、財務、配送、通知）をカバーしています。エンドポイントのパスと認証フローは公開仕様に準拠して実装されています。本番環境で使用する前に、ツールのコントラクトを実際の出品者トークンで統合テストしてください。LWA のリフレッシュフローと x-amz-access-token ヘッダーの使用方法は、現在の SP-API ドキュメントで確認済みです。

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: codespar
言語: node
バージョン: 0.2.0-alpha.3
トランスポート: stdio
掲載日: 2026年6月22日
最終更新: 4 週間前
公式 Registry: io.github.codespar/mcp-amazon

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

mcp-amazon

mcp-amazon について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@codespar/mcp-amazon

ツール（24）

インストール

環境変数

マーケットプレイスID（よく使われるもの）

認証

地域別ベース URL

実行

通知

ステータス

エンタープライズ

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？