vac-product-recommend-mcp

Lokaler stdio-MCP-Server: Sucht Produkte in der „Ausgewählt/Umfassend“-Liste der Ctrip-Gruppenreisen nach Bedarf und empfiehlt TopN nach Bewertungspunktzahl, Verkaufszahlen, Preis usw. Gibt ein einheitlich formatiertes Markdown-Tabellenformat zurück (mit Web-/Mobile-Links).

Reine Python-Standardbibliothek, keine Drittanbieter-Abhängigkeiten, Python 3.10+ reicht aus.

Bereitgestellte Tools

Related MCP server: 12306 Train Ticket Search MCP Server

Filter-Enum-Abfrage

Wenn Benutzeranforderungen auf konkrete Filterwerte abgebildet werden müssen, zuerst get_filter_options aufrufen:

{ "keyword": "川西" }

Gibt alle verfügbaren Filtergruppen und Enum-Werte aus fastFilters zurück. Der Agent kann darauf basierend auswählen und dann an search_tours / recommend_tours übergeben.

get_departure_cities wird nur verwendet, wenn der Benutzer eine Abfahrtsstadt erwähnt und eine ID benötigt; andernfalls wird die Standard-depart_city_id verwendet.

Installation (empfohlen mit uv, kein manuelles Python-Installieren nötig)

Zuerst nur uv installieren:

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

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

Dann über den Git-Link installieren:

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

Alternativ kann direkt das Installationsskript im Repository ausgeführt werden:

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

uv lädt Python und Abhängigkeiten beim ersten Lauf automatisch herunter, die Zielmaschine benötigt kein vorinstalliertes Python.

Update

Bereits installierte Benutzer aktualisieren je nach Installationsmethode:

# 用 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

Wenn die Client-Konfiguration uvx --from git+... verwendet, zuerst den Cache leeren und dann den MCP-Client neu starten:

uv cache clean

Nach dem Update muss der MCP neu gestartet / neu verbunden werden, damit die neuen Tools und Instructions wirksam werden.

Bei Installation/Update, wenn vom Agent durchgeführt, muss:

1. Streng geprüft werden, ob sich die Einschränkungen in diesem README unter „Wichtig: Agent muss Ausgabeformat strikt einhalten" und „Jede Beratung völlig unabhängig" geändert haben;

2. Die neuesten Einschränkungen in die Personalisierung / das Gedächtnis / die Rules / die System-Prompts des Agents synchronisiert werden;

3. Nach Neustart / Neuverbindung des MCP bestätigt werden, dass die Tool-Liste aktualisiert wurde.

Client-Konfiguration

Am Beispiel von Claude Desktop, claude_desktop_config.json bearbeiten:

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

Im Verzeichnis config_examples/ sind Beispielkonfigurationen für Claude Desktop / Cursor / Cline vorhanden.

Umgebungsvariablen:

Hauptparameter

recommend_tours / search_tours

So bekommt man das Cookie

1. Im Browser die Ctrip-H5-Gruppenreise-Liste öffnen (oder in DevTools auf mobile Simulation wechseln).

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

3. Rechtsklick → Copy → Copy as cURL.

4. Die gesamte Zeichenkette nach -b '...' in CTRIP_COOKIE einfügen (unverändert, nicht URL-kodieren).

Beispiel

Hilf mir, Guangxi 3-5 Tage selbstbetriebene Kleingruppen- oder Gruppenreisen zu finden, kinderfreundlich, empfehle 3.

Der Agent fragt zuerst die Abfahrtsstadt-ID ab (falls nötig), ruft dann das Empfehlungstool auf und gibt schließlich die Markdown-Tabelle unverändert zurück.

Wichtig: Agent muss Ausgabeformat strikt einhalten

Bitte fügen Sie in der Personalisierung / dem Gedächtnis / den System-Prompts / den Rules des Agents die folgende Einschränkung hinzu (dies ist die stabilste Ebene; wenn der Agent selbst ausführt, bitte gemäß Anforderung Selbstbeschränkung vornehmen):

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

Fügen Sie gleichzeitig die Einschränkung „Jede Beratung völlig unabhängig" hinzu:

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

Außerdem dürfen Personenzahl und Produkttyp nicht verwechselt werden:

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

Verzeichnisstruktur

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