项目简介

Crossmint Checkout MCP服务器允许您的大型语言模型 (LLM) 代理通过编程方式购买实体或虚拟商品和服务。它无需使用虚拟借记卡或模拟浏览器操作，即可实现可靠、高效的在线购买。只需提供商品标识符（如URL或SKU），您的AI代理即可完成购买流程。

主要功能点

• 创建订单: LLM代理可以调用此功能，指定商品标识符（支持亚马逊和Shopify），通过Crossmint完成商品的实际购买流程。
• 检查订单状态: 允许LLM代理查询已创建订单的当前处理状态。
• 获取账户余额: LLM代理可以查询与服务器关联的钱包中的USD余额。
• 支持的平台: 目前支持从Amazon (仅限美国) 和 Shopify (全球) 购买商品。

安装步骤

1. 克隆仓库:

   git clone https://github.com/Crossmint/mcp-crossmint-checkout.git
   cd mcp-crossmint-checkout
   

2. 安装依赖:

   npm install
   

3. 创建配置文件:

   cp .env.template .env
   

4. 获取Crossmint API密钥: 登录Crossmint控制台，创建服务器密钥，选择所需的权限范围（orders.create, orders.read, wallets:transactions.create, wallets.create, wallets.read, wallets.balance:read），并将API密钥复制到'.env'文件中。
5. 填写用户信息和收货地址: 在'.env'文件中填写购买商品的收货人姓名、地址、邮箱等信息，以及您公司的钱包地址。
6. 选择环境: 修改'.env'中的'ENV'变量，选择"test"进行测试订单，或选择"prod"进行真实订单。
7. 生成代理钱包: 运行以下命令为AI代理生成一个钱包地址，该地址将自动写入'.env'文件：

   npm run generate-agent-wallet
   

8. 转移信用点: 从公司钱包向代理钱包转移足够的信用点用于支付。例如，转移5点信用点给用户"johndoe"：

   npm run transfer-credits -- 5 johndoe
   

9. 构建项目:

   npm run build
   

服务器配置 (面向MCP客户端)

此MCP服务器设计用于被MCP客户端（如支持MCP协议的LLM应用）启动和管理。MCP客户端需要知道如何启动这个服务器进程并与其建立通信。

对于支持自动配置的客户端（如某些版本的Claude），您可以运行仓库中提供的脚本来更新客户端配置：

npm run update-claude-config

此脚本会根据您的'.env'文件，在客户端的配置文件中添加一个名为 'crossmint-checkout' 的MCP服务器配置项。

对于需要手动配置的客户端，您通常需要在客户端的配置界面或文件中提供以下信息：

• 服务器名称 (Server Name): 'crossmint-checkout'
• 启动命令 (Command): 'node'
• 启动参数 (Args): 'build/index.js' （假定客户端从仓库根目录启动）
• 环境变量 (Environment Variables): 客户端需要将 '.env' 文件中的所有配置项作为环境变量传递给服务器进程。这是因为服务器依赖这些环境变量（如 API 密钥、钱包地址、收货信息等）来运行。

客户端启动服务器后，服务器会通过标准输入/输出（Stdio）使用JSON-RPC协议与客户端通信。

基本使用方法 (面向LLM代理)

一旦服务器配置好并由您的LLM客户端启动，您可以像与任何其他工具一样指示LLM使用它。

1. 查找商品: 让LLM在亚马逊等平台查找您想要的商品，并获取商品的链接或标识符。
2. 指示购买: 让LLM调用 'create-order' 工具，并提供商品的标识符作为参数。例如：“购买这个商品：https://www.amazon.com/...”。
3. 检查状态: 随时可以询问LLM调用 'check-order' 工具，查询之前购买的订单状态。
4. 查询余额: 如果需要，可以询问LLM调用 'get-usd-balance' 工具，查询当前可用余额。

购买成功后，您会通过配置的邮箱收到购买收据。