使用说明

项目简介

本项目 'amazon-mcp' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为AI助手（如Claude）提供与Amazon电商平台交互的能力。通过该MCP服务器，AI助手可以执行商品搜索、获取支付报价、查看订单和用户信息等操作，从而实现智能化的Amazon购物体验。该服务器利用Fewsats提供的安全支付基础设施，保障交易安全。

主要功能点

商品搜索: 允许AI助手根据用户查询，在Amazon上搜索商品。
获取支付报价: 为指定商品生成支付报价，支持AI助手引导用户完成购买流程。
订单管理: 查询特定订单或用户的所有订单信息。
用户信息: 获取用户的个人资料和收货地址。

安装步骤

由于该仓库仅包含服务器端代码，你需要自行部署运行该服务器。以下是在本地运行的大致步骤：

克隆仓库:

git clone https://github.com/Fewsats/amazon-mcp.git
cd amazon-mcp

安装依赖: 虽然仓库中没有明确的依赖声明，但根据代码推测，你可能需要安装以下Python库。建议使用 'uv' 或 'pip' 进行安装。

# 使用 uv (如果已安装，参考README安装uv)
uv pip install fastmcp amazon-client  # amazon-client 可能是项目内部库，需要查看是否有提供或者自行实现

# 或者使用 pip
pip install fastmcp amazon-client #  amazon-client 可能是项目内部库，需要查看是否有提供或者自行实现

注意: 'amazon-client' 可能是一个内部库或者需要自行实现与Amazon API交互的客户端库。你需要检查项目是否有提供 'amazon-client' 库，如果没有，则需要自行创建或替换为其他Amazon API的Python SDK。

配置环境变量 (可选): 如果 'amazon-client' 需要访问Amazon API密钥或其他敏感信息，你可能需要在运行服务器前设置相应的环境变量。具体请参考 'amazon-client' 的文档或代码。

运行服务器: 在项目根目录下，执行以下命令启动 MCP 服务器：

uv python src/amazon_mcp/server.py
# 或者
python src/amazon_mcp/server.py

服务器默认会在本地启动，并监听 MCP 客户端的连接。

服务器配置

为了让 MCP 客户端（例如 Claude 或 Cursor）连接到该服务器，你需要在客户端的配置文件中添加服务器配置信息。根据 'README.md' 提供的示例，你需要配置 "Amazon" 服务器。

以下是推荐的客户端 MCP 服务器配置 (JSON 格式)，请将此配置添加到你的 MCP 客户端配置文件 (例如 Claude 的 'claude_desktop_config.json' 或 Cursor 的设置) 中：

{
  "mcpServers": {
    "Amazon": {  // 服务器名称，可以自定义，客户端用此名称引用
      "command": "uvx", // 启动服务器的命令，这里假设你使用 uvx 运行
      "args": [       // 命令参数
        "python",     // 实际执行的命令是 python
        "src/amazon_mcp/server.py" // 服务器脚本的路径
      ]
    }
  }
}

参数说明:

'"Amazon"': 服务器的名称，在客户端配置中用于标识和引用该服务器。你可以自定义名称。
'"command": "uvx"': 指定用于启动服务器的命令。这里假设你已经安装了 'uvx'，并且希望使用 'uvx' 来运行Python脚本。如果直接使用 'python' 命令，则将 '"command"' 修改为 '"python"' 即可，并相应调整 '"args"'。
'"args"': 一个字符串数组，包含传递给 '"command"' 的参数。
- '"python"': 指定使用 Python 解释器。
- '"src/amazon_mcp/server.py"': 指定要执行的服务器脚本的路径。请根据你的实际文件路径进行调整。

注意: 你需要根据你的实际环境（是否安装 'uvx'，Python 解释器路径，脚本路径等）调整 '"command"' 和 '"args"' 的配置。如果直接使用 'python' 命令，配置可以简化为：

{
  "mcpServers": {
    "Amazon": {
      "command": "python",
      "args": [
        "src/amazon_mcp/server.py"
      ]
    }
  }
}

基本使用方法

配置完成后，在你的 MCP 客户端（如 Claude）中，你可以通过自然语言指令来调用该 MCP 服务器提供的功能。例如：

商品搜索: 你可以对 Claude 说 "帮我在Amazon上搜索咖啡机" 或 "查找价格低于50美元的跑鞋"。服务器会将你的请求转换为 'search' 工具的调用。
购买商品: 在搜索到商品后，你可以指示 Claude 购买。服务器会调用 'get_payment_offers' 工具，并可能需要你提供收货地址和用户信息。
查看订单: 你可以询问 Claude "我的Amazon订单有哪些？" 或 "查看订单号为 XXXXX 的订单详情"。服务器会调用 'get_user_orders' 或 'get_order' 工具。

请参考 'src/amazon_mcp/server.py' 代码中 '@mcp.tool()' 装饰器下的函数注释，了解每个工具的具体功能和参数。 你需要根据 AI 助手的具体使用方式来触发这些工具的调用。

关键词