电商模型上下文协议服务器

一个简单的模型上下文协议(MCP)服务器,提供电商工具集,用于客户、订单和库存管理。

  • by KodyMullins
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 KodyMullins/mcp_test

使用说明

电子商务MCP服务器

一个带有测试数据的简单模型上下文协议(MCP)服务器。

设置

  1. 创建虚拟环境并安装依赖关系:

    uv venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    uv sync
    
  2. 在VS代码中配置MCP:

    • 导入VS Code Augment Extension的json配置在 .vscode/example-mcp.json
    • 用项目的绝对路径更新python和args路径
    • 安装后重新启动VS Code或重新加载MCP服务器(命令面板 Developer: Reload Window)

可用工具

服务器提供5个电子商务工具:

  • get_customer_info -按ID获取客户详细信息
  • get_customer_ids_by_name -按名称搜索客户ID
  • get_order_details -通过订单ID获取订单信息
  • get_orders_by_customer_id -获取客户的所有订单
  • check_inventory -按名称搜索产品库存

测试数据

客户

  • 艾丽斯·约翰逊 (CUST123)-alice@example.com, 555-1234
  • 鲍勃·史密斯 (CUST456)-bob@example.com, 555-5678

订单

  • 订单1001 -爱丽丝的订单(已发货,89.99美元)
  • 订单1015 -爱丽丝的订单(处理中,45.50美元)
  • 订单1022 -Bob的订单(已交付,120.00美元)

产品

  • SKU100 -无线鼠标($29.99,库存:42)
  • SKU200 -键盘($59.99,库存:18)
  • SKU300 -USB-C线缆(15.50美元,库存:77)

示例命令

使用MCP服务器尝试以下查询:

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

运行测试

pytest src/tests/test_server.py -v

将MCP服务器导入VS代码扩展的说明

  1. 打开VS代码扩展
  2. 单击设置图标(齿轮)并选择设置
  3. 点击工具部分
  4. 搜索并单击从json导入
  5. 从粘贴JSON .vscode/example-mcp.json 进入对话框
  6. 单击导入
  7. 重新启动VS代码命令面板 Developer: Reload Window