亚马逊产品情报代理

一个自主的模型上下文协议 (MCP) 服务器，用于抓取亚马逊产品详情和评论，管理本地 JSON 数据库存储，并使用丰富的 Prefab UI 仪表板可视化情报数据。

功能

• 异步抓取：使用 httpx 和 BeautifulSoup4 并发获取亚马逊的产品元数据（价格、标题、评论数、平均评分）及热门客户评论。

• 本地持久化：提供完整的 CRUD 操作，用于管理本地 JSON 数据库中的产品情报数据。

• 丰富仪表板：生成美观的 Prefab UI 仪表板，以可视化收集到的情报。

• MCP 标准：使用 fastmcp 与任何模型上下文协议客户端完全兼容。

先决条件

• Python 3.12+（推荐 64 位）

• Node.js（用于 MCP Inspector）

安装

本地设置

1. 克隆或下载存储库。

2. 在项目目录中打开终端。

3. 创建并激活虚拟环境：

   python -m venv venv
   source venv/Scripts/activate  # On Windows Git Bash
   # OR: .\venv\Scripts\activate # On Windows PowerShell

4. 安装依赖项：

   pip install -r requirements.txt

在线设置 (Replit / GitHub Codespaces)

如果您无法在本地安装依赖项，可以使用云端 IDE：

1. 将文件上传到 Replit 或 GitHub Codespace。

2. 在提供的终端中运行安装命令：pip install -r requirements.txt。

使用与测试

测试代理功能最简单的方法是使用官方的 MCP Inspector。

1. 启动检查器：

   npx @modelcontextprotocol/inspector python server.py

2. 在浏览器中打开提供的 localhost URL。

3. 导航到 Tools 选项卡以测试以下功能：

   • fetch_amazon_product：使用 ASIN（例如 B08N5WRWNW）来抓取数据。

   • manage_product_database：将抓取的 JSON 数据保存到本地数据库。

   • show_product_dashboard：查看为您保存的 ASIN 生成的 UI。

例如： https://www.amazon.in/Amazon-Brand-Presto-Oxo-Biodegradable-Garbage/dp/B0821PN8L4/ref=zg\\\\_bs\\\\_c\\\\_kitchen\\\\_d\\\\_sccl\\\\_1/259-9731870-4167526?pd\\\\_rd\\\\_w=cfXa7\\\\&content-id=amzn1.sym.b908f532-cbe7-4274-8b24-b671acc58bd2\\\\&pf\\\\_rd\\\\_p=b908f532-cbe7-4274-8b24-b671acc58bd2\\\\&pf\\\\_rd\\\\_r=F8ZX5X2ZT11NKKGT6PXC\\\\&pd\\\\_rd\\\\_wg=wuSNK\\\\&pd\\\\_rd\\\\_r=b24b1a45-e140-4aad-bc3c-4f47f6ec477e\\\\&pd\\\\_rd\\\\_i=B0821PN8L4\\\\&th=1

ASIN 是 B0821PN8L4

与 LLM 客户端集成

将服务器添加到您的 MCP 兼容客户端（例如 Claude Desktop）配置中：

{
  "mcpServers": {
    "amazon-intelligence": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}