verychic-mcp 0.1.0__tar.gz

verychic_mcp-0.1.0/.dockerignore

@@ -0,0 +1,13 @@
+.git
+.github
+docs
+tests
+dist
+build
+*.har
+.superpowers
+__pycache__
+*.pyc
+.venv
+.ruff_cache
+.pytest_cache

verychic_mcp-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,90 @@
+name: Release & Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run unit tests (offline) + lint
+        run: |
+          pytest
+          ruff check verychic_mcp tests
+
+  build:
+    name: Build Package
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v5
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # OIDC trusted publishing — no token stored
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v5
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v5
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          files: dist/*
+          generate_release_notes: true

verychic_mcp-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Secrets / credentials — never commit
+.env
+.env.*
+*.har
+secrets.*
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# Node (si la Phase 0 tranche pour Node/TS)
+node_modules/
+*.tsbuildinfo
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+
+# Scratch de pilotage (subagent-driven-development)
+.superpowers/

verychic_mcp-0.1.0/CLAUDE.md

@@ -0,0 +1,93 @@
+# CLAUDE.md — verychic-mcp
+
+Serveur MCP **non officiel, read-only, anonyme** pour les offres d'hôtels VeryChic.
+3 outils : `verychic_list_deals`, `verychic_search_offers`, `verychic_offer_details`
+(détail + disponibilité/prix par dates). HTTP pur (curl_cffi), double transport
+(stdio + streamable-http). Non affilié à VeryChic — voir le disclaimer du `README.md`.
+
+## Les 4 principes à intégrer
+
+1. **Think Before Coding** — expliciter les hypothèses ; si plusieurs interprétations, les présenter (ne pas trancher en silence) ; si plus simple existe, le dire ; si flou, s'arrêter et demander.
+2. **Simplicity First** — code minimal qui résout le problème ; rien de spéculatif ; pas d'abstraction pour usage unique ; si 200 lignes pour 50, réécrire.
+3. **Surgical Changes** — ne toucher que le nécessaire ; ne pas « améliorer » le code adjacent ; matcher le style existant ; signaler le dead code, ne pas le supprimer ; nettoyer seulement les orphelins créés par ses propres changements.
+4. **Goal-Driven Execution** — transformer la tâche en critères vérifiables (« fix the bug » → « écrire un test qui le reproduit puis le faire passer ») ; plan bref multi-étapes avec vérification par étape.
+
+## Commandes
+
+```bash
+pip install -e ".[dev]"               # installer (deps : curl_cffi, mcp[cli])
+pytest                                # tests hors-ligne (fixtures) — exclut @network
+pytest -m network                     # smoke-test réseau réel (touche l'API live, faible volume)
+ruff check verychic_mcp tests         # lint
+verychic-mcp --help                   # CLI (transports stdio / streamable-http)
+verychic-mcp                          # lance en stdio (défaut)
+python -m build                       # construit le wheel (publication)
+```
+
+Tests **hors-ligne** : ils tournent sur des fixtures JSON réelles dans `tests/fixtures/`
+(capturées en Phase 0), aucune dépendance réseau. Le smoke `@network` est opt-in et
+exclu de la CI par défaut (`addopts = "-m 'not network'"`).
+
+## Architecture (une responsabilité par module, testable isolément)
+
+```
+config.py      → constantes : routes, PRODUCT_PARAMS, rate-limit, fallback channelVersion
+errors.py      → VeryChicError + CloudflareBlocked / NotFound / UpstreamError (messages actionnables)
+http_client.py → VeryChicClient : session curl_cffi (empreinte Chrome), rate-limit injectable,
+                 classify_block() mappe les réponses HTTP en exceptions. get_json / get_text.
+discovery.py   → get_channel_version() : lit channelVersion sur le site live, fallback en dur
+models.py      → dataclasses Offer / Availability / OfferDetails (+ offer_url, cheapest_price)
+parsers.py     → JSON brut → modèles (tolérant aux champs manquants via .get)
+api.py         → list_deals / search_offers / offer_details : compose client + routes + parsers
+server.py      → FastMCP : enregistre les 3 outils, resolve_transport(), main()
+```
+
+Flux d'un appel : `server` (outil) → `api` (route + params) → `http_client.get_json` → `parsers` → modèle sérialisé en dict.
+
+## Spécificités de l'API VeryChic
+
+- Base unifiée : `https://api.verychic.com/verychic-endpoints/v1` (+ `search.verychic.com`).
+  Tout est **public/anonyme** (200 sans login), **pas de challenge Cloudflare** (confirmé en Phase 0).
+- **`memberStatus=PROSPECT`** = visiteur anonyme (valeur d'enum valide ; `P` est rejeté en 422).
+  Centralisé dans `config.PRODUCT_PARAMS` — un seul endroit à changer.
+- Deux types de `source` dans le catalogue, à router différemment dans `offer_details` :
+  - `ORCHESTRA` (hôtel) → base `/hotel/{source}/{id}.json` ; dispo via `/product/.../checkin-availabilities.json` (200).
+  - `ORCHESTRA_TO` (package tour-op) → base `/vacation-package/{source}/{id}.json` ; `checkin-availabilities` répond **400** → la dispo est **best-effort** (catch `NotFound`/`UpstreamError` → `[]`, mais on laisse remonter `CloudflareBlocked`).
+- Page d'offre côté site : `https://www.verychic.fr/p/{externalId}/{urlName}` (→ `Offer.offer_url`).
+- `channelVersion` (paramètre volatil de `preview.json`) est auto-découvert, avec fallback en dur dans `config.py`.
+
+## Conventions
+
+- **Read-only, anonyme, faible volume** : aucun credential, aucune écriture/réservation, rate-limit ≥ 1 s entre requêtes (dans `http_client`). Posture défensive : pas d'extraction massive, pas de contournement Cloudflare.
+- **Erreurs actionnables** : toujours via les exceptions de `errors.py`, jamais un stacktrace brut.
+- **TDD + fixtures réelles** : pour toute évolution des parsers/API, ajouter/étendre un test hors-ligne sur une fixture. Un changement de comportement face à l'API live se valide via le smoke `@network`.
+- Messages de commit / docs en français ; README en anglais (convention OSS).
+
+## Publication / Release
+
+Repo public : **https://github.com/jordantete/verychic-mcp**.
+
+La publication PyPI est **automatisée par `.github/workflows/release.yml`** au push d'un
+tag `v*` : `test → build → publish-pypi → github-release`. L'auth PyPI se fait par
+**Trusted Publishing (OIDC)** — **aucun token stocké**. Setup PyPI une fois : un *trusted
+publisher* (projet `verychic-mcp`, owner `jordantete`, repo `verychic-mcp`, workflow
+`release.yml`, environnement `pypi`).
+
+Publier une version (SemVer) :
+```bash
+git switch main && git pull
+pytest && ruff check verychic_mcp tests   # doit passer avant de tagger
+# bumper "version" dans pyproject.toml (X.Y.Z), puis :
+git add pyproject.toml && git commit -m "chore: release vX.Y.Z"
+git tag vX.Y.Z
+git push origin main --tags
+```
+Le workflow fait le reste (build + upload PyPI + GitHub Release). Une fois publié,
+`uvx verychic-mcp` fonctionne sans cloner. Ne jamais committer de token PyPI.
+
+## État & suivi
+
+MCP **fonctionnel et validé contre l'API live**, repo GitHub public, CI de release en place
+(sur `main`). Reste : 1ère publication PyPI (config trusted publisher + tag) et déploiement
+remote pour Cowork. Améliorations notées et suivi : projet Notion `verychic-mcp` et
+`docs/superpowers/` (spec, verdict Phase 0, plans).

verychic_mcp-0.1.0/DEPLOY.md

@@ -0,0 +1,31 @@
+# Deploying VeryChic MCP for Claude.ai / Cowork
+
+Cloud Claude clients only talk to **remote** MCP servers over HTTPS. To use VeryChic MCP from
+claude.ai or Cowork, self-host it in `streamable-http` mode and add it as a custom connector.
+
+## Option A — Docker (anywhere)
+
+```bash
+docker build -t verychic-mcp .
+docker run -p 8000:8000 verychic-mcp
+# serves streamable-http on http://localhost:8000 (put it behind HTTPS for real use)
+```
+
+## Option B — Render (1-click-ish)
+
+This repo ships a `render.yaml`. On [Render](https://render.com): New → Blueprint → point it at your
+fork. It builds the `Dockerfile` and exposes the server over HTTPS. Render injects `$PORT`
+automatically; the container's start command already honors it.
+
+## Add it to Claude.ai / Cowork
+
+1. Copy your deployment's HTTPS URL (e.g. `https://verychic-mcp.onrender.com`).
+2. Claude settings → Connectors → **Add custom connector** → paste the URL.
+3. The three `verychic_*` tools become available in your chats.
+
+## Notes
+
+- The server is **anonymous and read-only**; no secrets or environment variables are required.
+- Keep it private to you / low-traffic — see the disclaimer in the README.
+- Default bind host is `127.0.0.1` for local stdio use; the Docker image binds `0.0.0.0` so the
+  platform can route to it.

verychic_mcp-0.1.0/Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+COPY pyproject.toml README.md LICENSE ./
+COPY verychic_mcp ./verychic_mcp
+RUN pip install --no-cache-dir .
+
+ENV PORT=8000
+EXPOSE 8000
+
+# Transport HTTP distant ; l'hébergeur fournit $PORT.
+CMD ["sh", "-c", "verychic-mcp --transport streamable-http --host 0.0.0.0 --port ${PORT:-8000}"]

verychic_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VeryChic MCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

verychic_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: verychic-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for VeryChic hotel offers
+Project-URL: Homepage, https://github.com/jordantete/verychic-mcp
+Project-URL: Repository, https://github.com/jordantete/verychic-mcp
+Project-URL: Issues, https://github.com/jordantete/verychic-mcp/issues
+Author: VeryChic MCP contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: hotels,mcp,model-context-protocol,travel,verychic
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.11
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: mcp[cli]>=1.2
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# VeryChic MCP
+
+An **unofficial, read-only** [Model Context Protocol](https://modelcontextprotocol.io) server for
+[VeryChic](https://www.verychic.fr) hotel flash-sale offers. Search current deals, filter them, and
+get an offer's details with availability and prices by date — straight from your MCP client.
+
+> ⚠️ **Disclaimer.** This project is **not affiliated with, endorsed by, or connected to VeryChic /
+> VeryChic SAS** in any way. It is an independent, community tool for **personal use**. It accesses
+> VeryChic's public web API the same way a browser does. You are responsible for complying with
+> VeryChic's Terms (Conditions Générales de Vente — notably Art. 9 on intellectual property and the
+> *sui generis* database right). Use it at your own risk, for personal, low-volume browsing only.
+> Do not use it for bulk extraction or redistribution of VeryChic's data.
+
+## What it does
+
+Three tools:
+
+| Tool | Description |
+|---|---|
+| `verychic_list_deals` | The current VeryChic offers (limit configurable). |
+| `verychic_search_offers` | Filter offers by `destination` (substring), `country` (exact), and/or `max_price`. |
+| `verychic_offer_details` | An offer's content (advantages, gallery) **plus availability and prices by date**. |
+
+All read-only, anonymous (no login), with a built-in conservative rate limit.
+
+## Install & use (local — Claude Desktop / Claude Code)
+
+Zero-install with [`uv`](https://docs.astral.sh/uv/). Add this to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "verychic": {
+      "command": "uvx",
+      "args": ["verychic-mcp"]
+    }
+  }
+}
+```
+
+That runs the server over **stdio**. No clone, no manual install.
+
+To run it yourself:
+
+```bash
+uvx verychic-mcp            # stdio (default)
+uvx verychic-mcp --help     # see options
+```
+
+## Use from Claude.ai / Cowork (remote)
+
+Cloud clients (claude.ai web, Cowork) can only talk to **remote** MCP servers over HTTPS, so you must
+**self-host** the server in `streamable-http` mode and add it as a *custom connector* by URL. See
+[DEPLOY.md](DEPLOY.md) for a 1-click template. Then, in Claude settings → Connectors → Add custom
+connector, paste your deployment URL.
+
+> Listing in Anthropic's official connector directory (next to Booking/Tripadvisor) is **out of
+> scope**: it requires a partner review this kind of tool would not pass.
+
+## Tool examples
+
+- "List the current VeryChic deals."
+- "Search VeryChic offers in Spain under 600 €."
+- "Get the details and dated prices for VeryChic offer ORCHESTRA 44983."
+
+## Development
+
+```bash
+git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
+pip install -e ".[dev]"
+pytest                 # offline tests (fixtures); excludes the @network smoke test
+pytest -m network      # optional: hits the live VeryChic API (low volume)
+ruff check verychic_mcp tests
+```
+
+## How it works
+
+VeryChic's web front-end calls a public JSON API under `https://api.verychic.com/verychic-endpoints/v1`
+(plus `search.verychic.com`). This server replays those calls with a browser-like TLS fingerprint
+(`curl_cffi`), parses the responses, and exposes them as MCP tools. The volatile `channelVersion`
+parameter is auto-discovered from the live site, with a hardcoded fallback.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

verychic_mcp-0.1.0/README.md

@@ -0,0 +1,85 @@
+# VeryChic MCP
+
+An **unofficial, read-only** [Model Context Protocol](https://modelcontextprotocol.io) server for
+[VeryChic](https://www.verychic.fr) hotel flash-sale offers. Search current deals, filter them, and
+get an offer's details with availability and prices by date — straight from your MCP client.
+
+> ⚠️ **Disclaimer.** This project is **not affiliated with, endorsed by, or connected to VeryChic /
+> VeryChic SAS** in any way. It is an independent, community tool for **personal use**. It accesses
+> VeryChic's public web API the same way a browser does. You are responsible for complying with
+> VeryChic's Terms (Conditions Générales de Vente — notably Art. 9 on intellectual property and the
+> *sui generis* database right). Use it at your own risk, for personal, low-volume browsing only.
+> Do not use it for bulk extraction or redistribution of VeryChic's data.
+
+## What it does
+
+Three tools:
+
+| Tool | Description |
+|---|---|
+| `verychic_list_deals` | The current VeryChic offers (limit configurable). |
+| `verychic_search_offers` | Filter offers by `destination` (substring), `country` (exact), and/or `max_price`. |
+| `verychic_offer_details` | An offer's content (advantages, gallery) **plus availability and prices by date**. |
+
+All read-only, anonymous (no login), with a built-in conservative rate limit.
+
+## Install & use (local — Claude Desktop / Claude Code)
+
+Zero-install with [`uv`](https://docs.astral.sh/uv/). Add this to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "verychic": {
+      "command": "uvx",
+      "args": ["verychic-mcp"]
+    }
+  }
+}
+```
+
+That runs the server over **stdio**. No clone, no manual install.
+
+To run it yourself:
+
+```bash
+uvx verychic-mcp            # stdio (default)
+uvx verychic-mcp --help     # see options
+```
+
+## Use from Claude.ai / Cowork (remote)
+
+Cloud clients (claude.ai web, Cowork) can only talk to **remote** MCP servers over HTTPS, so you must
+**self-host** the server in `streamable-http` mode and add it as a *custom connector* by URL. See
+[DEPLOY.md](DEPLOY.md) for a 1-click template. Then, in Claude settings → Connectors → Add custom
+connector, paste your deployment URL.
+
+> Listing in Anthropic's official connector directory (next to Booking/Tripadvisor) is **out of
+> scope**: it requires a partner review this kind of tool would not pass.
+
+## Tool examples
+
+- "List the current VeryChic deals."
+- "Search VeryChic offers in Spain under 600 €."
+- "Get the details and dated prices for VeryChic offer ORCHESTRA 44983."
+
+## Development
+
+```bash
+git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
+pip install -e ".[dev]"
+pytest                 # offline tests (fixtures); excludes the @network smoke test
+pytest -m network      # optional: hits the live VeryChic API (low volume)
+ruff check verychic_mcp tests
+```
+
+## How it works
+
+VeryChic's web front-end calls a public JSON API under `https://api.verychic.com/verychic-endpoints/v1`
+(plus `search.verychic.com`). This server replays those calls with a browser-like TLS fingerprint
+(`curl_cffi`), parses the responses, and exposes them as MCP tools. The volatile `channelVersion`
+parameter is auto-discovered from the live site, with a hardcoded fallback.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

verychic_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "verychic-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for VeryChic hotel offers"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "VeryChic MCP contributors" }]
+keywords = ["mcp", "model-context-protocol", "verychic", "hotels", "travel"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = ["curl_cffi>=0.7", "mcp[cli]>=1.2"]
+
+[project.urls]
+Homepage = "https://github.com/jordantete/verychic-mcp"
+Repository = "https://github.com/jordantete/verychic-mcp"
+Issues = "https://github.com/jordantete/verychic-mcp/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "ruff>=0.6", "build>=1.2"]
+
+[project.scripts]
+verychic-mcp = "verychic_mcp.server:main"
+
+[tool.pytest.ini_options]
+markers = ["network: test nécessitant un accès réseau réel (hors CI)"]
+addopts = "-m 'not network'"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["verychic_mcp"]

verychic_mcp-0.1.0/render.yaml

@@ -0,0 +1,9 @@
+services:
+  - type: web
+    name: verychic-mcp
+    runtime: docker
+    plan: free
+    dockerfilePath: ./Dockerfile
+    # Pas de healthCheckPath : le serveur streamable-http sert MCP sur un sous-chemin,
+    # "/" renverrait 404. Render retombe sur un check d'ouverture du port.
+    autoDeploy: false

verychic_mcp-0.1.0/tests/fixtures/checkin_availabilities_sample.json

@@ -0,0 +1,42 @@
+[
+  {
+    "date": "20/06/2026",
+    "price": 169,
+    "currency": "EUR",
+    "departureCityCode": "XXX",
+    "nights": 1,
+    "days": 2
+  },
+  {
+    "date": "21/06/2026",
+    "price": 169,
+    "currency": "EUR",
+    "departureCityCode": "XXX",
+    "nights": 1,
+    "days": 2
+  },
+  {
+    "date": "22/06/2026",
+    "price": 169,
+    "currency": "EUR",
+    "departureCityCode": "XXX",
+    "nights": 1,
+    "days": 2
+  },
+  {
+    "date": "23/06/2026",
+    "price": 169,
+    "currency": "EUR",
+    "departureCityCode": "XXX",
+    "nights": 1,
+    "days": 2
+  },
+  {
+    "date": "24/06/2026",
+    "price": 169,
+    "currency": "EUR",
+    "departureCityCode": "XXX",
+    "nights": 1,
+    "days": 2
+  }
+]