UMKM CRM (MCP服务器)

一个轻量级的MCP服务器，用于通过SQLite管理**小微企业(UMKM)**的客户关系、产品销售和订单跟踪。

此服务器专为**微小企业(UMKM)**设计——从咖啡店到在线商店——它们需要简单的CRM功能，包括产品跟踪、客户记录、WhatsApp促销等。

---

✨ 特性

• 💾 记录客户订单和互动
• 📦 管理产品库存和销售
• 🔔 库存低时通知
• 📈 查看畅销产品和忠实客户
• 📄 每周活动导出至CSV
• 📲 发送WhatsApp促销（通过外部API）

---

📦 安装

从PyPI安装：

pip install crm-umkm

---

🚀 使用

你可以运行服务器使用：

uvx crm-umkm

或者在客户端如Cursor或任何兼容MCP的应用中进行配置：

{
  "mcpServers": {
    "crm-umkm": {
      "command": "uvx",
      "args": ["crm-umkm"],
      "env": {
        "DB_PATH": "/absolute/path/to/crm.db",
        "WHATSAPP_API_URL": "https://your-api.com/send",
        "WHATSAPP_API_TOKEN": "your-api-token"
      }
    }
  }
}

---

📁 环境变量

变量	描述	默认值
DB_PATH	SQLite数据库文件路径	crm_umkm.db
WHATSAPP_API_URL	发送WhatsApp消息的基础URL	https://api.whatsapp.com/send
WHATSAPP_API_TOKEN	验证WhatsApp API服务的令牌	(空)

数据库将在首次运行时自动初始化。

---

🧠 提示行为

此MCP服务器专门针对UMKM CRM任务。底层LLM被指导：

✅ 在以下情况下使用这些工具：

• 用户想要记录订单、查看产品统计、监控库存或导出活动报告
• 管理小微企业客户和互动
• 通过WhatsApp发送促销信息

🚫 避免用于：

• 企业级别的CRM需求
• 大规模营销活动自动化
• 大规模ERP工作流

---

📂 项目结构

crm-umkm/
└── src/
    └── crm_umkm/
        ├── __init__.py
        ├── server.py
        └── test.py

---

📝 许可证

ABRMS许可证