MCP 服务器

MCP System Backend

Avinashsharma01

开发者工具

访问服务器

README

MCP系统后端

一个强大的物料收集点（MCP）系统后端，用于管理合作伙伴、取件、订单和钱包交易。

概述

此服务器为 MCP 系统实现了一个 RESTful API，允许进行合作伙伴管理、取件安排、订单处理和钱包交易。它使用 Node.js、Express 和 MongoDB 构建。

目录结构

server/
├── config/             # 配置文件
│   └── db.js           # 数据库连接配置
├── controllers/        # 路由控制器
│   ├── authController.js      # 认证逻辑
│   ├── orderController.js     # 订单管理
│   ├── partnerController.js   # 合作伙伴管理
│   ├── pickupController.js    # 取件安排
│   └── walletController.js    # 钱包操作
├── middleware/         # Express 中间件
│   └── auth.js         # 认证 & 授权中间件
├── models/             # MongoDB 数据模型
│   ├── Order.js        # 订单模式
│   ├── Partner.js      # 合作伙伴模式
│   ├── Pickup.js       # 取件模式
│   ├── Transaction.js  # 交易模式
│   ├── User.js         # 用户模式
│   └── Wallet.js       # 钱包模式
├── routes/             # API 路由
│   ├── auth.js         # 认证路由
│   ├── order.js        # 订单管理路由
│   ├── partner.js      # 合作伙伴管理路由
│   ├── pickup.js       # 取件安排路由
│   └── wallet.js       # 钱包操作路由
├── scripts/            # 实用脚本
│   └── seed.js         # 数据库填充脚本
├── .env                # 环境变量
├── package.json        # 项目依赖和脚本
└── server.js           # 主应用程序入口点

设置

安装依赖:
```
npm install
```

设置环境变量: 在根目录中创建一个 .env 文件，包含以下变量：

PORT=5000
MONGO_URI=mongodb://localhost:27017/mcp-system
JWT_SECRET=your_jwt_secret

运行开发服务器:
```
npm run dev
```
填充数据库 (可选):
```
npm run seed
```

API 接口

所有 API 响应都遵循标准格式：

{
  "success": true|false,
  "message": "结果描述",
  "data": { /* 响应数据对象 */ }
}

认证

注册新用户

接口: POST /api/auth/register

请求体:

{
  "name": "John Doe",
  "email": "john@example.com",
  "password": "securePassword123",
  "phone":"6201693634",
  "role": "user"
}

响应:

{
  "success": true,
  "message": "注册成功",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": {
      "_id": "60d21b4667d0d8992e610c85",
      "name": "John Doe",
      "email": "john@example.com",
      "phone":"6201693634",
    }
  }
}

合作伙伴

注册合作伙伴

接口: POST /api/partners/register

请求体:

{
  "name": "EcoRecycle Inc",
  "email": "contact@ecorecycle.com",
  "password": "securePassword123",
  "role": "MCP"
}

响应:

{
  "success": true,
  "message": "合作伙伴注册成功",
  "data": {
    "partner": {
      "_id": "60d21b4667d0d8992e610c85",
      "name": "EcoRecycle Inc",
      "email": "contact@ecorecycle.com",
      "role": "MCP",
      "walletBalance": 0
    }
  }
}

获取合作伙伴详情

接口: GET /api/partners/:id

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

响应:

{
  "success": true,
  "data": {
    "partner": {
      "_id": "60d21b4667d0d8992e610c85",
      "name": "EcoRecycle Inc",
      "email": "contact@ecorecycle.com",
      "role": "MCP",
      "walletBalance": 500,
      "createdAt": "2023-04-05T14:30:45.123Z"
    }
  }
}

取件

创建取件

接口: POST /api/pickups/create

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

访问权限: 仅限 MCP 合作伙伴

请求体:

{
  "title": "每周可回收物取件",
  "description": "收集塑料和纸质材料",
  "address": "123 Green St, Eco City",
  "date": "2023-04-10T09:00:00.000Z",
  "assignedTo": "60d21b4667d0d8992e610c86",
  "commission": 50
}

响应:

{
  "success": true,
  "message": "取件创建成功",
  "data": {
    "pickup": {
      "_id": "60d21b4667d0d8992e610c87",
      "title": "每周可回收物取件",
      "description": "收集塑料和纸质材料",
      "address": "123 Green St, Eco City",
      "date": "2023-04-10T09:00:00.000Z",
      "status": "pending",
      "assignedTo": "60d21b4667d0d8992e610c86",
      "commission": 50,
      "createdAt": "2023-04-05T16:30:22.789Z"
    }
  }
}

获取我的取件

接口: GET /api/pickups/my

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

访问权限: 任何已认证的用户

响应:

{
  "success": true,
  "data": {
    "pickups": [
      {
        "_id": "60d21b4667d0d8992e610c87",
        "title": "每周可回收物取件",
        "description": "收集塑料和纸质材料",
        "address": "123 Green St, Eco City",
        "date": "2023-04-10T09:00:00.000Z",
        "status": "pending",
        "assignedTo": "60d21b4667d0d8992e610c86",
        "commission": 50,
        "createdAt": "2023-04-05T16:30:22.789Z"
      }
    ]
  }
}

更新取件状态

接口: PUT /api/pickups/:id/status

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

请求体:
```
{
  "status": "completed"
}
```

响应:

{
  "success": true,
  "message": "取件状态更新成功",
  "data": {
    "pickup": {
      "_id": "60d21b4667d0d8992e610c87",
      "status": "completed",
      "updatedAt": "2023-04-10T14:25:10.789Z"
    }
  }
}

筛选取件

接口: GET /api/pickups/filter

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

访问权限: 仅限 MCP 合作伙伴
查询参数:
- status: 按状态筛选（pending、completed、failed）
- date: 按日期筛选

响应:

{
  "success": true,
  "data": {
    "pickups": [
      {
        "_id": "60d21b4667d0d8992e610c87",
        "title": "每周可回收物取件",
        "description": "收集塑料和纸质材料",
        "address": "123 Green St, Eco City",
        "date": "2023-04-10T09:00:00.000Z",
        "status": "completed",
        "assignedTo": "60d21b4667d0d8992e610c86",
        "commission": 50,
        "createdAt": "2023-04-05T16:30:22.789Z"
      }
    ]
  }
}

订单

创建订单

接口: POST /api/orders/create

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

请求体:

{
  "items": [
    {
      "product": "再生纸",
      "quantity": 20,
      "price": 5.50
    }
  ],
  "shippingAddress": "789 Client St, Client City",
  "paymentMethod": "wallet"
}

响应:

{
  "success": true,
  "message": "订单创建成功",
  "data": {
    "order": {
      "_id": "60d21b4667d0d8992e610c88",
      "orderNumber": "ORD-20230405-001",
      "items": [
        {
          "product": "再生纸",
          "quantity": 20,
          "price": 5.50,
          "total": 110
        }
      ],
      "totalAmount": 110,
      "shippingAddress": "789 Client St, Client City",
      "paymentMethod": "wallet",
      "status": "pending",
      "createdAt": "2023-04-05T17:15:33.123Z"
    }
  }
}

获取我的订单

接口: GET /api/orders/my

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

响应:

{
  "success": true,
  "data": {
    "orders": [
      {
        "_id": "60d21b4667d0d8992e610c88",
        "orderNumber": "ORD-20230405-001",
        "items": [
          {
            "product": "再生纸",
            "quantity": 20,
            "price": 5.50,
            "total": 110
          }
        ],
        "totalAmount": 110,
        "status": "pending",
        "createdAt": "2023-04-05T17:15:33.123Z"
      }
    ]
  }
}

钱包

获取我的钱包

接口: GET /api/wallet/balance

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

响应:

{
  "success": true,
  "data": {
    "balance": 1250.75
  }
}

向钱包充值

接口: POST /api/wallet/deposit

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

请求体:

{
  "amount": 500,
  "paymentMethod": "credit_card"
}

响应:

{
  "success": true,
  "message": "充值成功",
  "data": {
    "transaction": {
      "_id": "60d21b4667d0d8992e610c90",
      "type": "deposit",
      "amount": 500,
      "description": "通过信用卡充值钱包",
      "createdAt": "2023-04-06T14:25:10.789Z"
    },
    "balance": 1750.75
  }
}

交易历史

接口: GET /api/wallet/transactions

请求头:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

响应:

{
  "success": true,
  "data": {
    "transactions": [
      {
        "_id": "60d21b4667d0d8992e610c90",
        "type": "deposit",
        "amount": 500,
        "description": "通过信用卡充值钱包",
        "createdAt": "2023-04-06T14:25:10.789Z"
      },
      {
        "_id": "60d21b4667d0d8992e610c91",
        "type": "withdrawal",
        "amount": 110,
        "description": "订单 ORD-20230405-001 的付款",
        "createdAt": "2023-04-05T17:30:45.123Z"
      }
    ]
  }
}

认证流程

注册/登录:
- 用户或合作伙伴使用相应的接口注册或登录
- 服务器响应一个 JWT 令牌
令牌使用:
- 在所有受保护的请求的 Authorization 标头中包含令牌：
```
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```
基于角色的访问:
- 某些接口根据用户角色受到限制
- 系统支持 "MCP" 和 "PickupPartner" 等角色
- 未经授权的访问尝试将被拒绝，并返回 403 错误

数据模型

用户

{
  name: String,         // 用户全名
  email: String,        // 用户邮箱（唯一）
  password: String,     // 哈希密码
  role: String,         // 授权角色
  status: String,       // 'ACTIVE', 'INACTIVE'
  createdAt: Date,
  updatedAt: Date
}

合作伙伴

{
  name: String,          // 合作伙伴名称
  email: String,         // 联系邮箱（唯一）
  password: String,      // 哈希密码
  role: String,          // 'MCP', 'PickupPartner'
  walletBalance: Number, // 当前钱包余额
  createdAt: Date,
  updatedAt: Date
}

取件

{
  title: String,         // 取件标题
  description: String,   // 取件描述
  address: String,       // 取件地点
  date: Date,            // 计划日期和时间
  status: String,        // 'pending', 'completed', 'failed'
  assignedTo: ObjectId,  // 引用 User/Partner
  commission: Number,    // 佣金金额
  createdAt: Date,
  updatedAt: Date
}

订单

{
  orderNumber: String,   // 格式化的订单号
  items: [{
    product: String,     // 产品名称
    quantity: Number,    // 数量
    price: Number,       // 单价
    total: Number        // 计算总价
  }],
  totalAmount: Number,   // 订单总额
  shippingAddress: String, // 配送地址
  paymentMethod: String, // 付款方式
  status: String,        // 'pending', 'processing', 'completed', 'cancelled'
  createdAt: Date,
  updatedAt: Date
}

交易

{
  type: String,          // 'deposit', 'withdrawal', 'transfer'
  amount: Number,        // 交易金额
  description: String,   // 交易描述
  status: String,        // 'completed', 'failed', 'pending'
  createdAt: Date
}

错误处理

所有 API 接口都返回标准化的错误响应：

{
  "success": false,
  "message": "描述错误的错误消息",
  "error": {
    "details": "其他错误详情（仅开发模式）"
  }
}

常见错误代码

400: Bad Request - 无效输入
401: Unauthorized - 需要身份验证
403: Forbidden - 用户缺少权限
404: Not Found - 资源不存在
500: Internal Server Error - 服务器端错误

环境变量

PORT - 服务器端口（默认：5000）
MONGO_URI - MongoDB 连接字符串
JWT_SECRET - JWT 身份验证的密钥
NODE_ENV - 环境（development、production）

数据库

系统使用 MongoDB 作为其数据库。通过 Mongoose 使用环境变量中指定的连接字符串建立连接。

模型包括：

User：用于身份验证和用户信息
Partner：物料收集合作伙伴和取件合作伙伴
Pickup：计划的物料取件
Order：订单处理
Transaction：财务交易记录

MCP System Backend

README

MCP系统后端

目录

概述

目录结构

设置

API 接口

认证

注册新用户

登录

合作伙伴

注册合作伙伴

获取合作伙伴详情

取件

创建取件

获取我的取件

更新取件状态

筛选取件

订单

创建订单

获取我的订单

钱包

获取我的钱包

向钱包充值

交易历史

认证流程

数据模型

用户

合作伙伴

取件

订单

交易

错误处理

常见错误代码

环境变量

数据库

推荐服务器