项目简介

amazon-fresh-server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它演示了如何通过 MCP 协议向 LLM 客户端提供工具功能。这个服务器提供了一个 'create_amazon_fresh_link' 工具，可以将食材列表转换为 Amazon Fresh 的购物链接，方便用户在线购买食材。

主要功能点

工具 (Tools): 提供 'create_amazon_fresh_link' 工具，接收食材列表作为输入，返回一个可以直接在 Amazon Fresh 上打开的购物链接。

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node Package Manager)。
下载仓库代码: 从 GitHub 仓库 https://github.com/Alec2435/amazon-fresh-server 下载代码到本地。
安装依赖: 打开终端，进入仓库代码目录，运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令编译 TypeScript 代码并生成可执行的 JavaScript 文件：
```
npm run build
```
构建成功后，会在 'build' 目录下生成 'index.js' 文件，这就是服务器的入口文件。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，你需要配置客户端，告诉它如何启动和连接到这个服务器。以 Claude Desktop 为例，你需要编辑配置文件 'claude_desktop_config.json'。

配置文件路径：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容示例：

在 'claude_desktop_config.json' 文件中，找到或创建 'mcpServers' 字段，并添加 'amazon-fresh-server' 服务器的配置。

{
  "mcpServers": {
    "amazon-fresh-server": {
      "command": "/path/to/amazon-fresh-server/build/index.js"
    }
  }
}

配置参数说明：

'"amazon-fresh-server"': 服务器的名称，可以自定义，用于在客户端中标识这个服务器。
'"command"': 重要，指向服务器启动命令的路径。你需要将 '/path/to/amazon-fresh-server/build/index.js' 替换为 你本地仓库 'build/index.js' 文件的绝对路径。例如，如果你的仓库代码放在 '~/Documents/amazon-fresh-server' 目录下，那么 'command' 应该配置为 '"/Users/你的用户名/Documents/amazon-fresh-server/build/index.js"' (MacOS) 或 '"C:\Users\你的用户名\Documents\amazon-fresh-server\build\index.js"' (Windows)。

注意: 'args' 字段在此服务器配置中不需要，因为此服务器通过标准输入/输出 (stdio) 进行通信，不需要额外的启动参数。

基本使用方法

启动 MCP 服务器: 当 Claude Desktop (或其他 MCP 客户端) 启动并加载配置后，'amazon-fresh-server' 会自动作为 MCP 服务器在后台运行。

在客户端中使用工具: 在 Claude Desktop 中，你可以指示 Claude 调用 'create_amazon_fresh_link' 工具，并提供食材列表作为参数。例如，你可以对 Claude 说：

请使用 create_amazon_fresh_link 工具为我创建一个 Amazon Fresh 购物链接，食材如下：
- 苹果
- 牛奶
- 面包

查看结果: 服务器会将生成的 Amazon Fresh 购物链接返回给 Claude Desktop，Claude 会在对话中显示这个链接。你可以点击链接在 Amazon Fresh 上查看和购买食材。

工具输入参数示例 (JSON 格式):

{
  "ingredients": [
    {
      "name": "apple"
    },
    {
      "name": "milk"
    },
    {
      "name": "bread"
    }
  ]
}

注意: 此服务器仅提供 'create_amazon_fresh_link' 工具，用于生成 Amazon Fresh 购物链接。它没有实现资源和 Prompt 模板功能，但作为一个 MCP 服务器的示例，它演示了工具功能的集成和使用。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息