vac-product-recommend-mcp

Servidor MCP local en formato stdio que busca productos en las listas «Destacados/General» de los tours en grupo de Ctrip según la demanda, y recomienda el TopN según dimensiones como puntuación de reseñas, ventas y precio. Devuelve una tabla Markdown en formato unificado (incluye enlaces de versión web y móvil).

Implementado solo con la librería estándar de Python, sin dependencias de terceros. Basta con Python 3.10+.

Herramientas incluidas

Related MCP server: 12306 Train Ticket Search MCP Server

Consulta de filtros enumerados

Cuando se deseen convertir las necesidades del usuario en valores de filtro concretos, llama primero a get_filter_options_:

{ "keyword": "川西" }

Devuelve todos los grupos de filtros y sus valores enumerados dentro de fastFilters. El Agent puede elegir según esto y luego pasarlos a search_tours / recommend_tours.

get_departure_cities se usa solo cuando el usuario menciona una ciudad de salida y se necesita el ID; en caso contrario, se usa el depart_city_id predeterminado.

Instalación (se recomienda usar uv, no es necesario instalar Python manualmente)

Primero instala uv:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

Después instala mediante el enlace git:

uv tool install git+https://github.com/KatouMegumii/vac-product-recommend-mcp

También puedes ejecutar directamente el script de instalación del repositorio:

./scripts/install.sh
# Windows: powershell -File scripts/install.ps1

v descargará Python y la dependencias automáticamente en la primera ejecución. No es necesario que la máquina objetivo tenga Python preinstalado.

Actualización

Los usuarios que ya tienen instalado el paquete deben actualizarlo según el método de instalación:

# 用 uv tool 安装的
uv tool upgrade vac-product-recommend-mcp
# 如果上面没拉到最新，强制重装：
uv tool install --force git+https://github.com/KatouMegumii/vac-product-recommend-mcp

# 克隆仓库 + pip install -e . 安装的
cd vac-product-recommend-mcp && git pull

Si la configuración del cliente usa uvx --from git+..., limpia la caché y reinicia el cliente de MCP:

uv cache clean

Después de la actualización, reinicia / vuelve a conectarte al MCP para que las nuevas herramientas y instructions entren en vigencia.

Al actualar/instalar, si la operación la realiza el Agent, lo siguiente es obligatorio:

1. Tocar estrictamente si las restricciones de este README para las secciones «Importante: para que el Agent mantenga estrictamente el formato de salida» y «Cada consulta es completamente independiente» han cambiado;

2. Sincronizar las últimas restricciones en la personalización / memoria / Rules / indicaciones del sistema del Agent;

3. Reiniciar / reconectar MCP y luego confirmar la lista de herramientas actualizada.

Configuración del cliente

Con Claude Desktop como ejemplo, edita claude_desktop_config.json:

{
  "mcpServers": {
    "vac-product-recommend": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/KatouMegumii/vac-product-recommend-mcp",
        "vac-product-recommend-mcp"
      ],
      "env": {
        "CTRIP_COOKIE": "",
        "CTRIP_GUID": ""
      }
    }
  }
}

En el directorio config_examples/ se incluirán configuraciones de ejemplo para Claude Desktop / Cursor / Cline.

Variables de entorno:

Parámetros principales

recommend_tours / search_tours

Cómo obtener la cookie

1. Abre la lista de viajes en grupo H5 de Ctrip en el navegador (o Cambia a modo móvil en DevTools).

2. F12 → Network → busca graphql?queryName=productSearchInfo.

3. Click derecho → Copy → Copy as cURL.

4. Pega toda la parte después del -b '...' en CTRIP_COOKIE (exactamente, sin URL-encoded).

Ejemplo

Ayúdame a buscar un recorrido de 3-5 días por Guangxi, de pequeño viaje por +.. o tour con grupo, que sea adecuado para familias; consulta el top 3.

Agent consulta primero si es necesario el ID de ciudad de salida que opcional, luego llama a la herramienta de recomendación y devuelve directamente la tabla Markdown.

Importante: para que el Aopt esté estricto con el formato de salida

Añade la siguiente restricción en la personalización / memoria / indicadores del sistema / añadir recordatorio al Agent (esta es la capa MÁS estable; si el Agent lo ejecuta por sí mismo, debe autoexigirse por igual):

当调用 vac-product-recommend 的 recommend_tours（又称mcp__recommend_tours） / 或 search_tours（又称mcp__search_tours） 后，
必须把工具返回的 Markdown（包含筛选项和表格） 原样作为最终回复输出。
禁止改写、禁止总结、禁止转成列表、禁止删除或合并列。

También añade la restricción de que cada consulta es completamente independiente:

每次调用 recommend_tours / search_tours 时，只根据当前这一轮用户的原话设置参数。
不要复用上一轮对话中的 keyword、travel_way、departure_date、days、team_size、budget 等参数。
如果用户新一轮没有提到某个筛选条件，就不要传该参数（使用默认值或留空）。

Además, no mezcles el número de participantes con el tipo de producto:

用户提到人数（如 4人、6人、8人）时，必须设置 team_size（4人→最多9人）。
用户只说人数，不要推断为私家团；用户只说私家团，才设置 travel_way=私家团。

Estructura del directorio

vac-product-recommend-mcp/
├── vac_product_recommend_mcp/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py         # stdio MCP 协议 + 工具注册 + Markdown 渲染
│   ├── ctrip_api.py      # 携程接口客户端 + 字段归一化 + 筛选
│   └── recommender.py    # 评分、过滤、TopN
├── config_examples/
├── pyproject.toml
└── README.md