BOS MCP Server

MCP (Model Context Protocol) server cho phép AI assistants (Claude, Cursor, Trae) tương tác trực tiếp với BOS ERP System qua REST API.

Tính năng

• 69 tools cho business operations

• TypeScript + Node.js 18+

• Token bucket rate limiting (60 RPM)

• Exponential backoff retry

• Stdio & HTTP transport

• JSON-RPC 2.0

Cài đặt

npm install
npm run build

Environment Variables

Chạy

# Stdio mode (default - cho Claude Code)
npm start

# HTTP mode (cho web deployments)
npm run http

Claude Code Integration

{
  "mcpServers": {
    "bos": {
      "command": "node",
      "args": ["/path/to/bos-mcp/dist/index.js"],
      "env": {
        "BOS_API_URL": "https://bos.ai.vn/api"
      }
    }
  }
}

Docker

FROM node:18-alpine
WORKDIR /app
COPY package.json dist/
RUN npm install
CMD ["node", "dist/http.js"]

Tools Categories (69 total)

Health & Management (18 tools)

• boscli_health_* - System health checks

• boscli_module_* - Module CRUD

• boscli_route_* - Route listing

• boscli_cache_* - Cache management

• boscli_system_* - System info, logs, git, deploy

Products (6 tools)

• bos_product_list, bos_product_show, bos_product_search

• bos_product_create, bos_product_update, bos_product_delete

Orders (6 tools)

• bos_order_list, bos_order_show, bos_order_create

• bos_order_update_status, bos_order_cancel, bos_order_count_by_status

Cart (7 tools)

• bos_cart_get, bos_cart_add_item, bos_cart_update_item

• bos_cart_remove_item, bos_cart_clear

• bos_cart_apply_voucher, bos_cart_remove_voucher

Customers (5 tools)

• bos_customer_list, bos_customer_show, bos_customer_create

• bos_customer_update, bos_customer_orders

Inventory (4 tools)

• bos_inventory_list, bos_inventory_check, bos_inventory_update

• bos_inventory_low_stock

Vouchers (4 tools)

• bos_voucher_list, bos_voucher_validate, bos_voucher_create

• bos_customer_vouchers

Loyalty (5 tools)

• bos_loyalty_points_balance, bos_loyalty_points_history

• bos_loyalty_earn, bos_loyalty_redeem, bos_loyalty_tiers

Stores (3 tools)

• bos_store_list, bos_store_show, bos_store_nearby

Checkout & Payment (4 tools)

• bos_checkout_calculate, bos_checkout_create

• bos_payment_methods, bos_payment_verify

Promotions (3 tools)

• bos_promotion_list, bos_promotion_show, bos_promotion_apply

Home & Engagement (4 tools)

• bos_home, bos_banners

• bos_notifications, bos_notification_mark_read

License

MIT