Aamar Dokan POS MCP Server

基本能力

产品定位

AD-POS-MCP-SERVER 是一个为零售 POS 系统设计的中间件服务，主要用于连接 MongoDB 数据库并提供数据操作、订单管理和 AI 辅助功能。

核心功能

• 🔒 安全的 MongoDB 连接
• 📊 带有安全验证的只读聚合管道
• 📦 订单生命周期管理
• 🤖 AI 辅助的销售操作提示生成
• 📈 业务分析能力
• 🔍 集合探索和模式发现
• 📱 与 Aamar Dokan POS 系统集成
• 🛡️ 使用 TypeScript 实现类型安全

适用场景

• 零售 POS 系统的订单管理
• 销售数据分析
• AI 辅助的销售操作
• 数据库集合的探索和模式发现

工具列表

• listCollections: 返回连接的 MongoDB 数据库中所有集合的列表
• getCollectionSchema: 返回集合中的示例文档以帮助识别其模式
• createOrder: 在数据库中创建新订单
• runAggregation: 在集合上执行 MongoDB 聚合管道
• create_sales_order: 生成创建销售订单的提示

常见问题解答

• MongoDB 连接失败: 验证 MongoDB URI 和网络设置
• 类型错误: 确保所有接口正确定义和使用
• MCP SDK 版本冲突: 本项目使用 MCP SDK v1.9.0

使用教程

使用依赖

• Node.js v18+
• npm v9+
• MongoDB v6+
• TypeScript v5+
• MCP SDK v1.9.0

安装教程

# 克隆仓库
git clone https://github.com/manishankarvakta/ad-pos-mcp-server.git
cd ad-pos-mcp-server

# 安装依赖
npm install

# 创建环境文件
cp .env.example .env

环境配置

在 .env 文件中配置环境变量：

MONGO_URI=mongodb://username:password@hostname:port/database?authSource=admin

调试方式

• 设置 DEBUG=true 在 .env 文件中以获取额外的日志记录
• 运行 npm run dev 启动开发服务器，支持热重载
• 运行 npm test 运行测试套件

许可证

该项目遵循 None 开源许可条款。