E-commerce MCP Server
A simple Model Context Protocol (MCP) server with test data.
Setup
-
Create virtual environment and install dependencies:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv sync -
Configure MCP in VS Code:
- The json config to import into VS Code Augment Extension is configured in
.vscode/example-mcp.json - Update the python and args paths with the absolute path to your project
- Restart VS Code or reload the MCP server after setup (Command Palette
Developer: Reload Window)
- The json config to import into VS Code Augment Extension is configured in
Available Tools
The server provides 5 e-commerce tools:
get_customer_info- Get customer details by IDget_customer_ids_by_name- Search for customer IDs by nameget_order_details- Get order information by order IDget_orders_by_customer_id- Get all orders for a customercheck_inventory- Search product inventory by name
Test Data
Customers
- Alice Johnson (CUST123) - alice@example.com, 555-1234
- Bob Smith (CUST456) - bob@example.com, 555-5678
Orders
- ORD1001 - Alice's order (Shipped, $89.99)
- ORD1015 - Alice's order (Processing, $45.50)
- ORD1022 - Bob's order (Delivered, $120.00)
Products
- SKU100 - Wireless Mouse ($29.99, stock: 42)
- SKU200 - Keyboard ($59.99, stock: 18)
- SKU300 - USB-C Cable ($15.50, stock: 77)
Example Commands
Try these queries with the MCP server:
Get customer info for Bob Smith
Show me order ORD1001
Check inventory for mouse
Get all orders for customer CUST123
Find customer ID for Alice Johnson
Running Tests
pytest src/tests/test_server.py -v
Directions to import the MCP server into VS Code Augment Extension
- Open the VS Code Augment Extension
- Click the Setting icon(Gear) and select settings
- Click on the tools section
- Search for and click import from json
- Paste the JSON from
.vscode/example-mcp.jsoninto the dialog box - Click import
- Restart VS Code Command Palette
Developer: Reload Window