Service MCP Amazon PA-API

Un service MCP (Model Context Protocol) pour l'intégration de l'API Amazon Product Advertising. Ce projet utilise le SDK Python officiellement fourni à Product Advertising API 5.0.

Intégration dans Claude & Cursor

Pour configurer l'hôte, la région et le marché, consultez la documentation Locale Reference for Product Advertising API.

{ "mcpServers" : { "amazon-paapi" : { "command" : "uvx", "args" : ["mcp-amazon-paapi" ], "env" : { "PAAPI_ACCESS_KEY" : "your-access-key", "PAAPI_SECRET_KEY" : "votre-clé-secrète", "PAAPI_PARTNER_TAG" : "your-partner-tag", "PAAPI_HOST" : "webservices.amazon.de", // sélectionnez les serveurs et la région de l'UE ou des États-Unis "PAAPI_REGION" : "eu-west-1", "PAAPI_MARKETPLACE" : "www.amazon.de" // définissez votre place de marché préférée } } } }

Structure du projet

mcp-amazon-paapi/ ├── src/ │ └─── mcp_amazon_paapi/ # Paquet principal │ ├── __init__.py # Initialisation du paquet │ ├── service.py # Classe de service Amazon PA-API avec injection de dépendance │ ├── server.py # FastMCP server implementation │ └── _vendor/ # Vendored dependencies │ └── paapi5_python_sdk/ # Amazon PA-API Python SDK ├── test/ # Test suite │ ├── __init__.py # Initialisation du package de test │ └── test_service.py # Tests pour le module de service ├── pyproject.toml # Configuration du projet et dépendances ├── uv.lock # Fichier de verrouillage des dépendances ├── README.md # Documentation du projet

Configuration locale

Configuration initiale

# Synchroniser les dépendances depuis uv.lock (crée l'environnement virtuel automatiquement) uv sync # Alternativement, activer l'environnement virtuel manuellement source .venv/bin/activate # Linux/Mac # ou .venv\Scripts\activate # Windows

Variables d'environnement

export PAAPI_ACCESS_KEY="your-access-key" export PAAPI_SECRET_KEY="your-secret-key" export PAAPI_PARTNER_TAG="your-partner-tag" export PAAPI_HOST="webservices.amazon.de" # optionnel par défaut webservices.amazon.de export PAAPI_REGION="eu-west-1" # optionnel par défaut eu-west-1 export PAAPI_MARKETPLACE="www.amazon.de" # optionnel par défaut www.amazon.de

Test

Exécutez la suite de tests simple :

# Exécuter tous les tests avec uv (recommandé) uv run python -m pytest test/test_service.py -v # Ou si vous avez activé l'environnement virtuel pytest test/test_service.py -v

La suite de tests comprend

• Tests d'initialisation du service
• Tests de gestion de la configuration
• Tests de fonctionnalité de recherche avec mocking
• Tests de gestion des erreurs

Utilisation

from service import AmazonPAAPIService # Créer un service (utilise les variables d'environnement) service = AmazonPAAPIService() # Rechercher des éléments items = service.search_items("echo dot", "Electronics", 5)

Exécution du serveur MCP

# Exécuter directement avec uv (recommandé) uv run python server.py # Ou si vous avez activé l'environnement virtuel python server.py