Servidor de búsqueda de productos MCP

Un servidor de búsqueda de productos basado en el Model Context Protocol (MCP), que permite a Claude buscar en el catálogo de productos mediante palabras clave y devolver datos estructurados.

Funcionalidades

Proporciona tres herramientas para que Claude las invoque:

Inicio rápido

1. Clonar el proyecto

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

2. Crear un entorno virtual e instalar dependencias

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]"

Requiere Python 3.10 o superior. Puede verificarlo con python3 --version.

3. Probar en el navegador

mcp dev server.py

El navegador abrirá automáticamente el MCP Inspector. Si no se abre automáticamente, acceda manualmente a la dirección que aparece en la terminal (normalmente http://localhost:6274).

Pasos para conectar:

1. Cambie el Command de la izquierda por la ruta absoluta al ejecutable de Python en su entorno virtual:

   • macOS/Linux: /ruta/absoluta/mcp-product-search/.venv/bin/python

   • Windows: C:\ruta\absoluta\mcp-product-search\.venv\Scripts\python.exe

2. En Arguments escriba server.py

3. Haga clic en Connect; si aparece Connected en la esquina inferior izquierda, la conexión fue exitosa

4. Haga clic en la pestaña Tools en la parte superior, seleccione la herramienta, rellene los parámetros y haga clic en Run Tool

4. Integrar con Claude Desktop

Localice el archivo de configuración:

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

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

Añada el siguiente contenido (reemplazando con la ruta absoluta real):

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

Para ver la ruta absoluta del directorio actual:

# macOS / Linux
pwd

# Windows
cd

Después de guardar el archivo de configuración, cierre completamente y reinicie Claude Desktop.

5. Integrar con Claude Code (línea de comandos)

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

Ejemplo de uso

Una vez integrado con Claude, puede hacer preguntas como:

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

Claude determinará automáticamente qué herramienta invocar y proporcionará una respuesta basada en los datos estructurados devueltos.

Descripción de los parámetros de las herramientas

search

Los resultados se ordenan por calificación de mayor a menor y por precio de menor a mayor.

Ejemplo de respuesta:

{
  "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

Sin parámetros. Devuelve todos los nombres de categorías y la cantidad de productos correspondiente.

get_product

Estructura del proyecto

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

Ampliación de datos de productos

El catálogo de productos actual contiene 12 datos de ejemplo escritos en products.py. Para reemplazarlo con datos reales, solo necesita modificar la función search_products(); no es necesario cambiar server.py.