项目简介

amazon-fresh-server 是一个基于 TypeScript 开发的 MCP 服务器，它演示了 MCP 协议的核心概念，通过提供一个 'create_amazon_fresh_link' 工具，可以将配料表转换为 Amazon Fresh 购物链接。

主要功能点

创建 Amazon Fresh 购物链接工具：
- 提供 'create_amazon_fresh_link' 工具，允许用户输入配料名称、数量和品牌等信息。
- 将配料信息编码并生成 Amazon Fresh 购物链接，方便用户在线购买食材。
- 工具接受结构化的配料信息，支持自定义配料名称、数量单位和品牌偏好。

安装步骤

安装依赖

在仓库根目录下，打开终端并执行以下命令安装项目依赖：
```
npm install
```
构建服务器

执行以下命令构建服务器代码：
```
npm run build
```
构建成功后，会在项目根目录下生成 'build' 目录，其中包含编译后的服务器代码 'index.js' 文件。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要配置客户端以连接到此服务器。以下是配置示例，您需要将占位符路径替换为实际路径。

配置示例 (claude_desktop_config.json):

{
  "mcpServers": {
    "amazon-fresh-server": {
      "command": "/path/to/amazon-fresh-server/build/index.js"  // 请替换为 amazon-fresh-server 项目 build 目录下的 index.js 文件的绝对路径
    }
  }
}

配置说明:

'"amazon-fresh-server"': 服务器名称，在客户端配置中用于标识此服务器。
'"command"': 服务器启动命令。您需要将 '/path/to/amazon-fresh-server/build/index.js' 替换为 amazon-fresh-server 项目 'build' 目录下的 'index.js' 文件的绝对路径。例如，如果您的项目位于 '~/projects/amazon-fresh-server'，则该路径可能类似于 '/Users/yourusername/projects/amazon-fresh-server/build/index.js'。

请务必根据您的实际项目路径修改 'command' 字段的值。

基本使用方法

启动服务器

MCP 服务器在配置到 MCP 客户端后，通常由客户端自动启动。如果您需要手动测试，可以在终端中执行 'build/index.js' 文件（需要 Node.js 环境）。

使用 MCP 客户端调用工具

在 MCP 客户端中，您可以使用 'create_amazon_fresh_link' 工具。工具需要 'ingredients' 参数，参数类型为包含配料信息的 JSON 对象数组。

工具调用示例 (JSON 格式):

{
  "tool_calls": [
    {
      "id": "tool_call_123",
      "type": "function",
      "function": {
        "name": "create_amazon_fresh_link",
        "arguments": {
          "ingredients": [
            {
              "name": "apple",
              "quantityList": [
                {
                  "unit": "count",
                  "amount": 2
                }
              ]
            },
            {
              "name": "milk",
              "quantityList": [
                {
                  "unit": "liters",
                  "amount": 1
                }
              ],
              "brand": "Organic Valley"
            }
          ]
        }
      }
    }
  ]
}

客户端发送包含上述 'tool_calls' 的请求给 MCP 服务器后，服务器会调用 'create_amazon_fresh_link' 工具，并返回包含 Amazon Fresh 购物链接的响应。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息