Servidor MCP de Productos de Amazon

Un servidor de Protocolo de Contexto de Modelo (MCP) que brinda a un asistente de IA (p. ej., Claude Code) herramientas para buscar e inspeccionar datos de productos de Amazon, a través de stdio.

Características

• search_products — busca productos por palabra clave.

• get_product — obtiene detalles completos de un solo producto por ID.

• Escrito en TypeScript estricto, validado en tiempo de ejecución con Zod.

• Probado con pruebas unitarias con Vitest.

• Analizado con ESLint (typescript-eslint) y formateado con Prettier.

Related MCP server: Amazon Product Intelligence Agent

Estructura del proyecto

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

Requisitos

• Node.js 20+

• npm

Primeros pasos

npm install
npm run dev

Esto inicia el servidor a través de stdio usando tsx, listo para ser conectado por un cliente MCP.

Conexión desde Claude Code

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

Scripts

Referencia de herramientas

search_products

Busca productos de Amazon por palabra clave (coincide con el nombre del producto, sin distinguir mayúsculas de minúsculas).

Entrada

{ "query": "kindle" }

Salida

[
  {
    "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

Obtiene detalles completos de un solo producto por su ID.

Entrada

{ "product_id": "kindle-paperwhite" }

Salida: un objeto Product, o null si ningún producto coincide.

Datos

Los datos de productos actualmente viven en un pequeño catálogo simulado en memoria (src/tools/product-data.ts) en lugar de una API de Amazon en vivo; esto mantiene el proyecto autocontenido y seguro de ejecutar sin credenciales. .env.example documenta las variables de entorno que necesitaría una integración real con la API.

Licencia

MIT © Ludovic Delot Bravo