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

custom-ecommerce-mcp

一个基于Model Context Protocol的电商产品管理服务器,提供完整的增删改查操作、AI自动生成描述、数据库集成和智能搜索功能。

article

README

🚀 MCP 电子商务服务器

这是一个全面的模型上下文协议(MCP)服务器,专为电子商务产品管理而设计。它支持 CRUD 操作、由人工智能驱动的产品描述生成,并且集成了数据库,能有效提升电商产品管理的效率和智能化水平。

✨ 主要特性

  • 🛍️ 完整的 CRUD 操作:可创建、读取、更新和删除产品。
  • 🤖 人工智能驱动的描述生成:利用 MCP 采样自动生成产品描述。
  • 📊 数据库集成:集成了具有合理架构的 MySQL 数据库。
  • 🔍 智能搜索:支持按产品名称搜索,并具备分页功能。
  • 📦 低库存监控:可跟踪库存水平。
  • 🌐 双传输支持:同时支持标准输入输出(stdio)和 HTTP/SSE 传输。
  • 🔧 TypeScript 编写:使用 Zod 验证,实现全类型化。
  • 📋 MCP 资源:包含产品目录和低库存资源。
  • 🎯 MCP 提示模板:提供预构建的提示模板。

🚀 快速开始

# 1) 安装依赖
npm i

# 2) 准备环境变量
cp .env.example .env

# 3) 创建数据库架构(可选,在 MySQL 中运行)
# 请参考 sql/schema.sql

# 4) 运行非 MCP 演示
npm run dev:demo

# 5) 运行 MCP 服务器(标准输入输出传输)
npm run dev:mcp

MCP 服务器不会输出特殊信息,它会在标准输入输出上等待像 Claude Desktop、MCP Inspector 或 Apps SDK 这样的客户端连接。

📚 详细文档

发布包

# 链接本地包
npm link

# 登录 npm
npm login

# 发布公共包
npm publish --access public

💡 使用建议

  • 本项目设计简洁,适合用于学习和教程。
  • 所有数据库参数均来自环境变量。
  • 你可以扩展项目,添加事务处理、分页、身份验证等功能。
help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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