商品集成服务器

VkusVill MCP服务器

MCP（Model Context Protocol）是一款与俄罗斯杂货店连锁店Vestville集成的服务器。

使用官方MCP API味觉别墅（https://mcp001.vkusvill.ru/mcp).

机会

• 搜索产品 -搜索关键字与排序和破坏
• 产品详情 -组成、KZU、价格、评级
• 创建垃圾 -生成链接，快速将产品添加到购物车

安装

# Клонировать репозиторий
git clone <url>
cd vvmcp

# Создать виртуальное окружение
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# или .venv\Scripts\activate  # Windows

# Установить зависимости
pip install -e .

使用

连接Claude Code

创建文件 .mcp.json 在项目文件夹中：

{
  "mcpServers": {
    "vkusvill": {
      "command": "/path/to/vvmcp/.venv/bin/python",
      "args": ["-m", "vvmcp.server"],
      "cwd": "/path/to/vvmcp"
    }
  }
}

连接Claude Desktop

添加到配置中（~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vkusvill": {
      "command": "python",
      "args": ["-m", "vvmcp.server"],
      "cwd": "/path/to/vvmcp"
    }
  }
}

可用工具

搜索产品

按关键词搜索商品

参数：

• query （必填）-搜索请求
• page -页面号（默认为1）
• sort -排序： popular, rating, price_asc, price_desc

例子：

Найди молоко ВкусВилл 3.2%

get_product_details

获取有关产品的详细信息（成分、KZU）。

参数：

• product_id （必填）-产品ID

get_product_by_url

通过URL获取产品信息。

参数：

• url （必填）-产品参考

URL 示例 ： https://vkusvill.ru/goods/moloko-3-2-1-l-173.html

create_cart_link

创建指向购物车的链接。

参数：

• items （必填）-大量商品：
  • xml_id -产品XML ID（来自搜索结果）
  • quantity -数量（默认为1）

例子：

{
  "items": [
    {"xml_id": "173", "quantity": 2},
    {"xml_id": "36296", "quantity": 1}
  ]
}

返回： 视图引用 https://vkusvill.ru/?share_basket=XXXXXXXXXX

建筑

vvmcp/
├── src/vvmcp/
│   ├── __init__.py
│   ├── client.py      # Клиент для MCP API ВкусВилл
│   └── server.py      # MCP сервер
├── pyproject.toml
└── README.md

它是如何工作的

1. VkusvillClient (client.py）-官方MCP API Vestville客户端：

   • 通过JSON-RPC初始化会话
   • 调用工具： vkusvill_products_search, vkusvill_product_details, vkusvill_cart_link_create

2. MCP服务器 (server.py）实现Claude MCP协议的服务器

限制

• 检查地址的可用性 -官方API不提供特定交货地址的可用性信息。这需要一个单独的Puppeteer服务（见下文）。 openclaw宅男指南).

致谢

项目灵感来自 openclaw宅男指南 -部署人工智能机器人与雅思维尔集成的指南。

许可证

麻省理工学院