Servei Amazon PA-API MCP

Un servei Model Context Protocol (MCP) per a la integració de l'API de Publicitat de Productes d'Amazon. Aquest projecte utilitza el SDK oficial de Python proporcionat a Product Advertising API 5.0.

Integració a Claude & Cursor

Per configurar l'amfitrió, la regió i el mercat, consulteu la documentació 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": "your-secret-key",
        "PAAPI_PARTNER_TAG": "your-partner-tag",
        "PAAPI_HOST": "webservices.amazon.de",  // selecteu els servidors EU o US i la regió
        "PAAPI_REGION": "eu-west-1",
        "PAAPI_MARKETPLACE": "www.amazon.de" // establiu el mercat preferit
      }
    }
  }
}

Estructura del projecte

mcp-amazon-paapi/
├── src/
│   └── mcp_amazon_paapi/           # Paquet principal
│       ├── __init__.py             # Inicialització del paquet
│       ├── service.py              # Classe de servei Amazon PA-API amb injecció de dependències
│       ├── server.py               # Implementació del servidor FastMCP
│       └── _vendor/                # Dependències vendored
│           └── paapi5_python_sdk/  # SDK Python de Amazon PA-API
├── test/                           # Suite de proves
│   ├── __init__.py                 # Inicialització del paquet de proves
│   └── test_service.py             # Proves per al mòdul de servei
├── pyproject.toml                  # Configuració del projecte i dependències
├── uv.lock                         # Fitxer de bloqueig de dependències
├── README.md                       # Documentació del projecte

Configuració local

Configuració inicial

# Sincronitza les dependències de uv.lock (crea l'entorn virtual automàticament)
uv sync

# Alternativament, activa l'entorn virtual manualment
source .venv/bin/activate  # Linux/Mac
# o
.venv\Scripts\activate     # Windows

Variables d'entorn

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"       # opcional, per defecte webservices.amazon.de
export PAAPI_REGION="eu-west-1"                 # opcional, per defecte eu-west-1
export PAAPI_MARKETPLACE="www.amazon.de"        # opcional, per defecte www.amazon.de

Proves

Executeu la suite de proves simple:

# Executeu totes les proves amb uv (recomanat)
uv run python -m pytest test/test_service.py -v

# O si heu activat l'entorn virtual
pytest test/test_service.py -v

La suite de proves inclou:

• Proves d'inicialització del servei
• Proves de gestió de configuració
• Proves de funcionalitat de cerca amb simulació
• Proves de gestió d'errors

Ús

from service import AmazonPAAPIService

# Crea el servei (utilitza les variables d'entorn)
service = AmazonPAAPIService()

# Cerca d'articles
items = service.search_items("echo dot", "Electronics", 5)

Executant el servidor MCP

# Executeu directament amb uv (recomanat)
uv run python server.py

# o si heu activat l'entorn virtual
python server.py