Skip to main content
Glama
nam181196

Web Shop MCP Server Proxy

by nam181196
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

WebShop MCP Server (Proxy & OAuth-enabled)

MCP Server đóng vai trò Gateway kết nối MCP Client (Cursor, Claude Desktop, ChatGPT) tới WebShop Backend API (Express.js / Node.js). Hỗ trợ cơ chế phân quyền RBAC (Role-Based Access Control) cho User và Admin dựa trên OAuth JWT hoặc API Key.

🛠 Cấu hình sử dụng trên MCP Client (Cursor / Claude Desktop)

Người dùng không cần truyền thủ công api_key trong mỗi câu prompt. Thay vào đó, bạn cấu hình 2 instance MCP Server trong file mcp.json tương ứng với từng Role:

{
  "mcpServers": {
    "SportShop_Admin": {
      "command": "/Users/nam/Desktop/MCP_server/venv_new/bin/python3",
      "args": [
        "/Users/nam/Desktop/MCP_server/server.py"
      ],
      "env": {
        "MCP_API_KEY": "mcp_key_admin_test"
      }
    },
    "SportShop_User": {
      "command": "/Users/nam/Desktop/MCP_server/venv_new/bin/python3",
      "args": [
        "/Users/nam/Desktop/MCP_server/server.py"
      ],
      "env": {
        "MCP_API_KEY": "mcp_key_user_test"
      }
    }
  }
}

Related MCP server: mcp-coffee

💬 Ví dụ câu lệnh Prompt chuẩn (Không cần truyền api_key)

Dành cho Admin (SportShop_Admin):

  • "Lấy tất cả đơn hàng trong hệ thống giúp tôi."

  • "Xem thống kê doanh thu và báo cáo tổng quan đơn hàng."

  • "Thêm sản phẩm mới tên 'Giày Chạy Bộ Nike Air Zoom', giá 2500000, thuộc danh mục 'Giày', thương hiệu 'Nike'."

Dành cho User (SportShop_User):

  • "Cho tôi xem danh sách sản phẩm đang bán thuộc danh mục Giày."

  • "Xem danh sách các đơn hàng cá nhân của tôi."

  • "Tạo đơn hàng mua 2 sản phẩm ID P01."

🏗 Kiến trúc thư mục dự án

MCP_server/
├── auth/
│   ├── oauth_provider.py      ← Xác thực Token & fallback tự lấy MCP_API_KEY từ env
│   ├── user_service.py        ← Ánh xạ tài khoản OAuth sang WebShop Backend Token
│   ├── token_service.py       ← Xác minh & đọc JWT Token
│   └── scopes.py              ← Định nghĩa & kiểm tra Scope cho Role (admin / user)
├── config/
│   ├── auth_config.py         ← Cấu hình Issuer & mặc định Scopes
│   └── web_shop_config.py     ← URL Backend & API Key mappings
├── services/
│   └── web_shop_client.py     ← Client gửi HTTP Request tới WebShop Backend API
├── tools/
│   └── web_shop_tools.py      ← Đăng ký MCP Tools (api_key là tùy chọn)
└── server.py                  ← Server entrypoint (STDIO / HTTP / SSE)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp.shop

    doodlydan
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP-based web shop server that enables users to authenticate and order t-shirts through MCP tools. Features secure authentication with WorkOS AuthKit and admin functionality for viewing order details.
    1
    MIT

  • woo-mcp-server

    maneeshkumarsaraswat
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables managing WooCommerce stores through a web dashboard and MCP, including viewing products and orders, updating stock quantities, and deleting products via the WooCommerce REST API.
    -