使用说明
项目简介
AI_Claude_MCP 是一个 MCP 服务器,它作为一个桥梁连接了 Claude 这样的大语言模型客户端和 Amazon Fresh 在线生鲜购物平台。通过这个服务器,用户可以使用自然语言与 Claude 交流,规划购物清单,并最终生成可以直接在 Amazon Fresh 上使用的购物链接。
主要功能点
- 创建 Amazon Fresh 购物链接: 服务器提供了一个名为 'create_amazon_fresh_link' 的工具,允许 Claude 调用并传递食材列表。服务器会将这些食材转换成 Amazon Fresh 可识别的格式,并生成一个包含所有商品的购物链接。用户可以直接点击此链接跳转到 Amazon Fresh 网站或 App,快速将商品加入购物车。
安装步骤
- 安装 Node.js 和 npm: 确保您的计算机上已安装 Node.js 和 npm (Node 包管理器)。
- 下载仓库代码: 从 GitHub 仓库 https://github.com/michaelnguyen102/AI_Claude_MCP 下载代码到本地。
- 安装依赖: 打开终端或命令提示符,进入仓库代码根目录,运行以下命令安装项目依赖:
npm install - 构建服务器: 运行以下命令构建服务器代码:
构建成功后,会在项目根目录下生成 'build' 文件夹,服务器的可执行文件 'index.js' 位于 'build' 文件夹内。npm run build
服务器配置
要将此 MCP 服务器与 Claude 桌面客户端配合使用,您需要编辑 Claude 的配置文件 '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"' 字段(如果不存在则创建),并添加以下配置信息。请根据您的实际情况修改 'command' 字段中的路径。
{ "mcpServers": { "amazon-fresh-server": { "command": "/path/to/AI_Claude_MCP/build/index.js" } } }
配置参数说明:
- '"amazon-fresh-server"': 服务器名称,您可以自定义,Claude 客户端使用此名称来引用该服务器。
- '"command"': 重要。指向服务器启动命令的路径。请将 '/path/to/AI_Claude_MCP/build/index.js' 替换为您本地仓库 'build/index.js' 文件的绝对路径。
请注意: 'args' 字段在此配置中为空,因为此服务器示例不需要额外的启动参数。
基本使用方法
- 启动服务器: 在配置完成后,当 Claude 桌面客户端启动时,会自动尝试连接您配置的 MCP 服务器。您无需手动启动服务器,服务器会在后台运行。
- 与 Claude 交互: 您可以使用自然语言与 Claude 交流您的购物需求。例如,您可以对 Claude 说:
- "我想买一些食材做晚餐,需要西红柿,牛肉和洋葱。"
- "帮我创建一个 Amazon Fresh 购物清单,清单里要有牛奶,鸡蛋和面包。"
- Claude 调用工具: 当 Claude 理解您的购物意图后,可能会调用 'create_amazon_fresh_link' 工具,并要求您提供食材列表。
- 获取购物链接: 服务器在接收到 Claude 发送的食材列表后,会生成 Amazon Fresh 购物链接,并通过 Claude 返回给您。Claude 会以 Markdown 格式渲染此链接,您可以直接点击链接跳转到 Amazon Fresh 进行购物。
调试: 如果遇到问题,可以使用 'npm run inspector' 命令启动 MCP Inspector 进行调试,具体方法请参考仓库 README 文档。
信息
分类
生产力应用