Сервер поиска продуктов MCP

Сервер поиска продуктов на базе Model Context Protocol (MCP), позволяющий Claude искать в каталоге продуктов по ключевым словам и возвращать структурированные данные.

Функции

Предоставляет три инструмента для вызова Claude:

Быстрый старт

1. Клонирование проекта

git clone <your-repo-url>
cd mcp-product-search

2. Создание виртуального окружения и установка зависимостей

macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate
pip install "mcp[cli]"

Windows:

python -m venv .venv
.venv\Scripts\activate
pip install "mcp[cli]"

Требуется Python 3.10 или выше. Можно проверить с помощью python3 --version.

3. Тестирование в браузере

mcp dev server.py

Браузер автоматически откроет MCP Inspector. Если он не открылся автоматически, перейдите по адресу, указанному в терминале (обычно http://localhost:6274).

Шаги подключения:

1. Измените Command слева на абсолютный путь к Python в виртуальном окружении:

   • macOS/Linux: /абсолютный_путь/mcp-product-search/.venv/bin/python

   • Windows: C:\абсолютный_путь\mcp-product-search\.venv\Scripts\python.exe

2. В поле Arguments введите server.py

3. Нажмите Connect, если в левом нижнем углу отображается Connected, значит, подключение успешно

4. Перейдите на вкладку Tools вверху, выберите инструмент, заполните параметры и нажмите Run Tool

4. Подключение к Claude Desktop

Найдите файл конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте следующее содержимое (замените на фактические абсолютные пути):

{
  "mcpServers": {
    "product-search": {
      "command": "/绝对路径/mcp-product-search/.venv/bin/python",
      "args": ["/绝对路径/mcp-product-search/server.py"]
    }
  }
}

Просмотр абсолютного пути к текущей директории:

# macOS / Linux
pwd

# Windows
cd

После сохранения файла конфигурации полностью закройте и перезапустите Claude Desktop.

5. Подключение к Claude Code (командная строка)

claude mcp add product-search \
  /绝对路径/mcp-product-search/.venv/bin/python \
  /绝对路径/mcp-product-search/server.py

Примеры использования

После подключения к Claude можно задавать вопросы следующим образом:

帮我搜索苹果品牌的笔记本电脑
找一款评分 4.8 以上、价格不超过 300 美元的耳机
列出所有产品分类
查询产品 P003 的详细信息

Claude автоматически определит, какой инструмент вызвать, и предоставит ответ на основе возвращенных структурированных данных.

Описание параметров инструментов

search

Результаты сортируются по рейтингу (от высокого к низкому) и цене (от низкой к высокой).

Пример ответа:

{
  "keyword": "apple",
  "filters": { "category": "Laptops", "max_price": null, "min_rating": null },
  "total_results": 1,
  "products": [
    {
      "id": "P001",
      "name": "Apple MacBook Pro 14-inch M3",
      "category": "Laptops",
      "brand": "Apple",
      "price": 1999.0,
      "currency": "USD",
      "stock": 42,
      "rating": 4.8,
      "description": "14-inch Liquid Retina XDR display, M3 chip, 18GB RAM, 512GB SSD.",
      "tags": ["laptop", "apple", "macbook", "m3", "professional", "portable"]
    }
  ]
}

list_categories

Без параметров. Возвращает названия всех категорий и соответствующее количество продуктов.

get_product

Структура проекта

mcp-product-search/
├── server.py        # MCP 服务器，定义工具
├── products.py      # 产品目录与搜索逻辑
├── pyproject.toml   # 项目依赖
└── README.md

Расширение данных о продуктах

Текущий каталог продуктов состоит из 12 примеров данных, записанных в products.py. Чтобы заменить их на реальные данные, достаточно изменить функцию search_products(), файл server.py менять не нужно.