Amazon Selling Partner API MCP Server

Amazon Selling Partner API MCP サーバー

Amazon Selling Partner API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、標準化されたインターフェースを通じて Amazon SP-API の機能にアクセスするためのツールとリソースを提供します。

## 特長

- Amazon SP-API による認証と認可
- SP-API エンドポイントを幅広くカバー
- API リファレンスのドキュメントリソース
- カタログ、在庫、注文、レポートなどを管理するツール
- 安全な認証情報の取り扱い

## 前提条件

- Node.js 16 以降
- Amazon Selling Partner API の認証情報
- 適切な権限を持つ AWS 認証情報

## インストール

```bash
npm install amazon-sp-api-mcp-server
```

または、npx で直接実行します。

```bash
npx amazon-sp-api-mcp-server
```

## 設定

ルートディレクトリに `.env` ファイルを作成し、Amazon SP-API の認証情報を設定します。

```
SP_API_CLIENT_ID=your_client_id
SP_API_CLIENT_SECRET=your_client_secret
SP_API_REFRESH_TOKEN=your_refresh_token
SP_API_AWS_ACCESS_KEY=your_aws_access_key
SP_API_AWS_SECRET_KEY=your_aws_secret_key
SP_API_ROLE_ARN=your_role_arn
SP_API_MARKETPLACE_ID=ATVPDKIKX0DER
SP_API_REGION=us-east-1
```

## 使用方法

サーバーを起動します。

```bash
npm start
```

自動再起動を有効にして開発する場合：

```bash
npm run dev
```

MCP Inspector でテストする場合：

```bash
npm run inspect
```

## 利用可能なツール

このサーバーは、Amazon Selling Partner API のさまざまな機能と連携するツールを提供します。

- 認証ツール
- カタログツール
- 在庫管理
- 注文処理
- レポートの生成と取得
- フィードの送信
- 財務データへのアクセス
- 通知管理
- 商品価格
- 出品情報の管理
- FBA 操作

## ドキュメントリソース

`amazon-sp-api://{category}` リソースを通じて API ドキュメントにアクセスできます。category には次のいずれかを指定します。

- overview
- authentication
- catalog
- orders
- inventory
- reports
- feeds
- finance
- notifications
- productPricing
- listings
- fba

## ライセンス

MIT