AI导哈

NFC产品管理服务器

一个用于NFC操作的产品收集管理、客户跟踪和Shopify集成的模型上下文协议（MCP）服务器。

  • by laskar-ksatria
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 laskar-ksatria/mcp-server

使用说明

MCP NFC服务器

一个用于NFC操作的模型上下文协议（MCP）服务器，具备产品收集管理、客户追踪和Shopify集成功能。

🚀 安装

# Install globally
npm install -g mcp-server-nfc

# Or install locally
npm install mcp-server-nfc

🛠️ 可用工具

1. ping - 连接测试

测试服务器连接及健康状态。

  • 参数无
  • 退货“砰！”如果服务器运行正常

2. get_customer_information - 获取客户数据

检索客户信息及其产品收藏。

  • 参数：
    • email (字符串) - 客户电子邮件地址
  • 回报包含产品集合的客户数据

3. unpair_product_collection - 移除产品

从客户的收藏中移除该产品。

  • 参数：
    • unique_code (字符串) - 产品的唯一代码
  • 退货确认已取消配对

4. add_customer_product_collection - 添加产品集合

将产品添加到客户的收藏夹中。

  • 参数：
    • slug (字符串) - 产品别名
    • unique_code (字符串) - 产品的唯一代码
    • email (字符串) - 客户电子邮件
    • nfc_code （字符串）- NFC 代码
  • 退货成功确认并附上产品详情

5. get_uturn_information - 获取Uturn数据

使用NFC代码从Uturn API获取数据。

  • 参数：
    • nfc (字符串) - 要查询的NFC代码
  • 回报来自Uturn API的数据

6. get_product_stories - 获取产品详情

获取详细的产品信息和故事。

  • 参数：
    • slug (字符串) - 产品别名（或产品标识符）
  • 回报完整的产品数据，包括故事（或背景信息）

7. get_product_detail - 获取基础产品信息

获取基本产品信息。

  • 参数：
    • slug (字符串) - 产品别名
  • 退货基本产品标题和信息

🔧 环境配置

创建一个 .env 包含以下变量的文件：

# Database Configuration
ATLAS_NAME=your_mongodb_username:password
ATLAS_ADDRESS=your_cluster.mongodb.net
ATLAS_COLLECTION=your_database_name

# API Configuration
UTURN_API=your_uturn_api
SHOPIFY_STOREFRONT_ACCESSTOKEN=your_shopify_token
SHOPIFY_STORE_DOMAIN=https://your-store.myshopify.com
SHOPIFY_API_VERSION=2024-10

# Security
KEY=your_encryption_key

📋 Claude 桌面配置

添加到您的 claude-desktop-config.json：

{
  "mcpServers": {
    "nfc-server": {
      "command": "npx",
      "args": ["mcp-server-nfc"],
      "env": {
        "ATLAS_NAME": "your_mongodb_username:password",
        "ATLAS_ADDRESS": "your_cluster.mongodb.net",
        "ATLAS_COLLECTION": "your_database_name",
        "UTURN_API": "uturn_api",
        "SHOPIFY_STOREFRONT_ACCESSTOKEN": "your_shopify_token",
        "SHOPIFY_STORE_DOMAIN": "https://your-store.myshopify.com",
        "SHOPIFY_API_VERSION": "2024-10",
        "KEY": "your_encryption_key"
      }
    }
  }
}

🎯 使用示例

测试连接

# Test if server is running
ping

获取客户信息

# Get customer data
get_customer_information email="customer@example.com"

将产品添加到收藏夹

# Add product to customer collection
add_customer_product_collection \
  slug="product-handle" \
  unique_code="UNIQUE123" \
  email="customer@example.com" \
  nfc_code="NFC456"

获取U-turn（掉头）信息

# Get data from Uturn API
get_uturn_information nfc="NFC456"

获取产品详情

# Get product information
get_product_stories slug="product-handle"

🔍 主要特点

  • 产品系列管理 - 向客户收藏夹中添加/移除产品
  • 客户数据检索 - 获取客户信息及其产品
  • NFC集成 - 使用NFC代码和外部API
  • Shopify 集成 - 从Shopify商店前端获取产品数据
  • 保修跟踪 - 自动保修期到期计算
  • 历史记录 - 跟踪产品所有权历史
  • 错误处理 - 全面的错误管理和验证

📊 工具分类

类别 工具
连接 ping
客户管理 get_customer_information
产品管理 get_product_detail， get_product_stories
藏品管理 add_customer_product_collection， unpair_product_collection
外部API get_uturn_information

🚀 快速入门

  1. 安装该软件包：

    npm install -g mcp-server-nfc

  2. 配置环境变量 在你的 .env 文件

  3. 添加到Claude桌面配置:

    {
  "mcpServers": {
    "nfc-server": {
      "command": "npx",
      "args": ["mcp-server-nfc"],
      "env": {
        /* your environment variables */
      }
    }
  }
}

  4. 重启Claude桌面版 加载MCP服务器

📄 许可证

MIT 许可证 - 详见 LICENSE 文件。

👨‍💻 作者

LaskarAntikode 翻译成中文是“反代码战士”或“反编译者之队”，具体翻译可能根据上下文和语境有所调整。 - GitHub

用心打造，用于NFC产品管理和客户追踪

相关 MCP