返回 MCP 目录
public公开dns本地运行

products-info-mcp-server

这是一个基于MCP协议的产品信息服务器,专门用于获取Caffeine Army旗下SuperCoffee等产品的详细信息,包括名称、描述、价格和供应商等数据。项目通过Shopify API获取数据,使用Node.js和TypeScript构建。

article

README

🚀 MCP 产品信息服务器

MCP(模型上下文协议)服务器,用于提供 Caffeine Army 产品(特别是 SuperCoffee)的详细信息。

🚀 快速开始

MCP 产品信息服务器借助 Shopify 应用程序编程接口,为你提供 Caffeine Army 产品的详细信息。以下是启动该服务器的步骤:

  1. 确保你已安装 Node.js 和 NPM 或 Yarn,并且正确配置了环境变量。
  2. 按照后续的安装和配置步骤进行操作。

✨ 主要特性

  • 利用 Shopify 应用程序编程接口获取产品详细信息,涵盖产品名称、描述、价格、供应商等。
  • 提供 get-products 工具,可返回 SuperCoffee 的详细信息。

📦 安装指南

安装依赖

克隆仓库后,在项目根目录下执行以下命令安装依赖:

npm install

配置环境变量

在项目根目录下创建一个 .env 文件,并添加以下内容:

SHOPIFY_SHOP=your-shop.myshopify.com
SHOPIFY_STOREFRONT_TOKEN=your_token

💻 使用示例

构建服务器

要构建服务器,请执行以下命令:

npm run build

此步骤非常重要,它能确保你的服务器连接成功。

使用可用工具

get-products

该工具可返回 SuperCoffee 的详细信息,包括产品标题、完整描述、当前价格和供应商信息。

测试服务器

你需要配置你的 LLM 客户端与该服务器。以下是一个使用 Cursor.ai 的示例:

{
    "mcpServers": {
        "products-info": {
            "command": "node",
            "args": [
                "/绝对路径/到父目录/FOLDER/products-info/build/index.js"
            ],
            "env": {
              "SHOPIFY_SHOP": "your-store.myshopify.com",
              "SHOPIFY_STOREFRONT_TOKEN": "TOKEN"
            }
        }
    }
}

📚 详细文档

项目结构

├── src/
│   ├── index.ts          # 服务器入口点
│   └── @types/          # TypeScript 定义
├── .env                 # 环境变量文件(未版本控制)
├── package.json        # 依赖和脚本
└── README.md          # 本文件

🔧 技术细节

本项目使用了以下技术:

  • TypeScript
  • Node.js
  • MCP SDK
  • Shopify API
  • Axios

📄 许可证

此项目使用 MIT 许可证。更多细节请查看 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端