ebay-mcp

eBay Developers Program の OAuth 2.0（User access token） で呼び出す REST API を、Cursor / Claude から使うための Model Context Protocol サーバーです。

実行には Python 3.10 以上が必要です。macOS の /usr/bin/python3 が 3.9 の場合は、/opt/homebrew/bin/python3.11 -m venv .venv のように新しいランタイムで仮想環境を作成してください。

対応していること

• Commerce Identity — サインインしたアカウントのプロフィール検証（GET /commerce/identity/v1/user/）

• Buy Browse — item_summary/search と単品 item/{id} の取得

• トークン更新 — EBAY_REFRESH_TOKEN があれば 401 時に自動でリフレッシュを試行（プロセス内のみ）

• OAuth 補助 — ebay-mcp-auth で Authorization Code を取得し、mcp.json 用の env 断片を表示

環境変数（秘密情報はコードに書かない）

ユーザーがチャットなどに貼った Cert Id は無効化（ローテーション）済みとして扱い、mcp.json の env のみへ再設定することを強く推奨します。

初回: ユーザートークンの取得（ebay-mcp-auth）

1. Keys → User Tokens (OAuth) で Ru Name に次と一致する Redirect URL を登録
   （例）https://127.0.0.1:8765/callback

2. 端末から:

cd projects/ebay-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .

export EBAY_ENV=sandbox
export EBAY_CLIENT_ID="<App Id>"
export EBAY_CLIENT_SECRET="<Cert Id>"
export EBAY_REDIRECT_URI="https://127.0.0.1:8765/callback"

python -m ebay_mcp.auth

ブラウザで eBay にサインインし、許可後に自動で localhost に戻ります。表示された mcp.json フラグメント の env を Cursor の MCP 設定へマージします。

コードだけ貼った場合は、リダイレクト URL に含まれる code= を次のように渡します。

ebay-mcp-auth --code '<code の値のみ>'

Browse 検索などで権限エラーになる場合は、Dev Console で 追加の OAuth scope に対応した Ru Name / アプリ権限があるか確認し、EBAY_OAUTH_SCOPE を拡張してください。

疎通

EBAY_ENV=sandbox EBAY_CLIENT_ID=... EBAY_CLIENT_SECRET=... EBAY_ACCESS_TOKEN=... EBAY_REFRESH_TOKEN=... \\
  ebay-mcp-check

成功時末尾に OK: end-to-end eBay access works. が表示されます。

Cursor 登録

examples/cursor_mcp_config.example.json を参考にしてください。公開前は uvx --from /abs/path/to/projects/ebay-mcp でローカルパス指定もできます。

MIT License © 2026 taka392