Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client