Amazon Product Research MCP Server

Ein Model Context Protocol (MCP)-Server, der einem KI-Assistenten (z. B. Claude Code) Werkzeuge zum Suchen und Untersuchen von Amazon-Produktdaten über stdio bereitstellt.

Funktionen

• search_products — durchsucht Produkte nach Schlüsselwort.

• get_product — ruft vollständige Details für ein einzelnes Produkt anhand der ID ab.

• Geschrieben in striktem TypeScript, zur Laufzeit mit Zod validiert.

• Mit Vitest auf Unit-Ebene getestet.

• Mit ESLint (typescript-eslint) gelintet und mit Prettier formatiert.

Related MCP server: Amazon Product Intelligence Agent

Projektstruktur

src/
├── index.ts              # Entry point: wires the server to a stdio transport
├── server.ts              # Registers MCP tools on the McpServer instance
├── types/
│   └── product.ts         # Shared Product type
└── tools/
    ├── product-data.ts     # In-memory product catalog (mock data)
    ├── search-products.ts  # search_products tool: input schema + handler
    └── get-product.ts      # get_product tool: input schema + handler
tests/
├── search-products.test.ts
└── get-product.test.ts

Voraussetzungen

• Node.js 20+

• npm

Erste Schritte

npm install
npm run dev

Dies startet den Server über stdio mit tsx, bereit, von einem MCP-Client verbunden zu werden.

Verbindung von Claude Code aus

claude mcp add amazon-research -- npx tsx /absolute/path/to/amazon-product-research-mcp/src/index.ts

Skripte

Werkzeugreferenz

search_products

Durchsucht Amazon-Produkte nach Schlüsselwort (Übereinstimmung mit dem Produktnamen, ohne Beachtung der Groß-/Kleinschreibung).

Eingabe

{ "query": "kindle" }

Ausgabe

[
  {
    "id": "kindle-paperwhite",
    "name": "Kindle Paperwhite",
    "price": 169.99,
    "currency": "USD",
    "rating": 4.7,
    "reviewCount": 12543,
    "description": "A high-resolution e-reader designed for reading comfortably indoors and outdoors."
  }
]

get_product

Ruft vollständige Details für ein einzelnes Produkt anhand seiner ID ab.

Eingabe

{ "product_id": "kindle-paperwhite" }

Ausgabe: ein einzelnes Product-Objekt oder null, wenn kein Produkt übereinstimmt.

Daten

Produktdaten befinden sich derzeit in einem kleinen In-Memory-Mock-Katalog (src/tools/product-data.ts) und nicht in einer Live-Amazon-API — das hält das Projekt eigenständig und sicher ausführbar, ohne dass Zugangsdaten erforderlich sind. .env.example dokumentiert die Umgebungsvariablen, die eine echte API-Integration benötigen würde.

Lizenz

MIT © Ludovic Delot Bravo