内容
<!-- mcp-name: io.github.jordantete/verychic-mcp -->
<div align="center">
<img src="https://raw.githubusercontent.com/jordantete/verychic-mcp/main/assets/logo.png" alt="VeryChic MCP" width="96" height="96" />
# VeryChic MCP
### 从任意MCP客户端查找、筛选和定价VeryChic酒店优惠
浏览当前闪购优惠，按目的地或价格筛选，并通过日期查看优惠的可用性和价格。只读，匿名，无需账户。
<br>
[](https://pypi.org/project/verychic-mcp/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/jordantete/verychic-mcp/actions/workflows/release.yml)
[](https://www.python.org/)
[](https://modelcontextprotocol.io)
[](https://smithery.ai/servers/tetej171/verychic-mcp)
[](https://glama.ai/mcp/servers/jordantete/verychic-mcp)
<br>
[](https://cursor.com/install-mcp?name=verychic&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ2ZXJ5Y2hpYy1tY3AiXX0=)
[](https://insiders.vscode.dev/redirect/mcp/install?name=verychic&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22verychic-mcp%22%5D%7D)
</div>
---
> **只读和匿名。** 该服务器仅*搜索和读取*优惠 - 它从不预订，从不登录，并且不使用凭证。客户端中内置了保守的速率限制（≥ 1秒请求之间）。有关使用条款，请参见[免责声明](#免责声明)。
## 演示
将托管的VeryChic MCP服务器作为自定义连接器添加到Claude Desktop，然后询问西班牙优惠低于€600：
▶ [观看MP4](assets/connect-claude-desktop.mp4)
## 快速开始
将服务器添加到您的MCP客户端配置中。安装了[`uv`](https://docs.astral.sh/uv/)后，无需克隆或安装：
```json
{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
这会在stdio上运行服务器，这是Claude Desktop和Claude Code使用的。您也可以直接运行它：
```bash
uvx verychic-mcp # stdio (default)
uvx verychic-mcp --help # 所有选项
```
相同的`command`/`args`对在每个stdio客户端中都有效；只有包装配置不同。
这些配置适用于**本地客户端**（stdio）。对于claude.ai或Cowork等云客户端，它们通过HTTPS连接服务器，请参阅[从Claude.ai或Cowork使用](#use-from-claudeai-or-cowork)。
<details>
<summary><b>Claude Code</b> （一行代码）</summary>
```bash
claude mcp add verychic -- uvx verychic-mcp
```
</details>
<details>
<summary><b>Cursor</b> — <code>~/.cursor/mcp.json</code></summary>
```json
{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
</details>
<details>
<summary><b>VS Code</b> — <code>.vscode/mcp.json</code> （注意<code>servers</code>键）</summary>
```json
{
"servers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
</details>
<details>
<summary><b>Windsurf</b> — <code>~/.codeium/windsurf/mcp_config.json</code></summary>
```json
{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
</details>
---
## 工具
| 工具 | 返回内容 |
| --- | --- |
| `verychic_list_deals` | 当前VeryChic优惠，带有可配置的限制。 |
| `verychic_search_offers` | 按`destination`（子字符串匹配）、`country`（精确匹配）和`max_price`筛选的优惠。 |
| `verychic_offer_details` | 一个优惠的内容（优点、画廊）及其按日期的可用性和价格。 |
每个调用都是只读和匿名的，客户端中内置了保守的速率限制。
### `verychic_list_deals`
返回当前优惠（优惠对象列表）。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `limit` | integer | 否 | 返回的最大优惠数量。默认为`20`。 |
### `verychic_search_offers`
返回匹配每个筛选器的优惠（筛选器组合使用AND）。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `destination` | string | 否 | 优惠的目的地或名称的子字符串匹配（不区分大小写）。 |
| `country` | string | 否 | 精确的国家匹配（不区分大小写，例如`"Espagne"`）。 |
| `max_price` | number | 否 | 仅保留价格低于或等于此值的优惠。 |
| `limit` | integer | 否 | 返回的最大优惠数量。默认为`20`。 |
### `verychic_offer_details`
返回一个优惠的完整内容以及酒店按日期的可用性和价格。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `source` | string | 是 | `ORCHESTRA`用于酒店，`ORCHESTRA_TO`用于旅游运营商套餐。 |
| `external_id` | integer | 是 | 优惠的ID，由`verychic_list_deals` / `verychic_search_offers`返回。 |
---
## 示例
询问您的助手类似问题：
- "列出当前的VeryChic优惠。"
- "搜索西班牙优惠低于600欧元。"
- "获取ORCHESTRA酒店优惠44983的详细信息和按日期的价格。"
- "获取ORCHESTRA_TO套餐优惠301375的详细信息。" 旅游运营商套餐将航班与酒店捆绑在一起，因此它们不像单个酒店那样公开按日期的价格。工具仍然返回优惠内容和优势，并设置`availabilities_supported: false`，以便空的`availabilities`读取为"不支持此优惠类型"，而不是"无可用日期"。
优惠带有`source`（`ORCHESTRA`用于酒店，`ORCHESTRA_TO`用于套餐）和`external_id`。两者都从`verychic_list_deals`和`verychic_search_offers`返回，因此助手可以自行将它们传递给`verychic_offer_details`。
`verychic_list_deals`结果是优惠对象的列表（此处显示一个，修剪）：
```jsonc
{
"source": "ORCHESTRA",
"external_id": 36509,
"name": "Sofitel New York ****",
"destination": "New York, États-Unis",
"country": "États-Unis",
"price": 182,
"currency": "EUR",
"discount": 57.0,
"sales_mode": "FLASH",
"offer_end_date": "2026-06-24T23:55+0200",
"image": "https://.../sofitel-new-york.jpg",
"advantages": ["Petit-déjeuner inclus", "VeryFlexible : réservez en toute sérénité !"],
"offer_url": "https://www.verychic.fr/p/36509/etats-unis-new-york-hotel-sofitel-new-york"
}
```
`verychic_offer_details`添加`gallery`、`included_added_values`、`cheapest_price`和酒店按日期的`availabilities`：
```jsonc
{
"offer": { "source": "ORCHESTRA", "external_id": 44983, "name": "Hotel Kaktus Playa *****", "...": "..." },
"cheapest_price": 169,
"availabilities_supported": true,
"availabilities": [
{ "date": "20/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 },
{ "date": "21/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 }
]
}
```
---
## 从Claude.ai或Cowork使用
与[快速开始](#quick-start)中的本地客户端不同，云客户端如claude.ai和Cowork仅通过HTTPS连接远程MCP服务器，而不是本地进程。要在那里使用VeryChic MCP，请在`streamable-http`模式（`verychic-mcp --transport streamable-http`，在HTTPS后面）自行托管它，并添加它作为自定义连接器，粘贴带有`/mcp`路径的部署URL。
一个公共实例已部署在`https://verychic-mcp.fly.dev/mcp`以供方便使用。将其添加为claude.ai/Cowork中的自定义连接器，或将其连接到本地客户端以支持远程MCP：
```json
{
"mcpServers": {
"verychic": {
"url": "https://verychic-mcp.fly.dev/mcp"
}
}
}
```
这是尽力而为的，可能会在任何时候暂停或限制速率 - 对于快速尝试以外的任何操作，请运行自己的实例并使用上面的`uvx`命令或托管`streamable-http`模式。
将VeryChic MCP列入Anthropic的官方连接器目录（在Booking或Tripadvisor旁边）是不可能的。该目录仅适用于通过审查的合作伙伴集成，而此类工具不会。
---
## 工作原理
VeryChic网络应用程序通过`https://api.verychic.com/verychic-endpoints/v1`（加上`search.verychic.com`）与公共JSON API对话。该服务器重放相同的调用，并带有类似浏览器的TLS指纹（`curl_cffi`），解析响应为类型化对象，并将它们公开为MCP工具。所有操作无需登录。唯一的易变请求参数`channelVersion`在启动时从实时站点读取，如果读取失败，则回退到已知值。
---
## 开发
```bash
git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
pip install -e ".[dev]"
pytest # 离线测试，针对记录的fixtures运行
pytest -m network # 可选的烟雾测试，针对实时API，低容量
ruff check verychic_mcp tests
```
发布由标签驱动。推送`vX.Y.Z`标签会运行测试，构建包，并通过GitHub Actions使用[trusted publishing](https://docs.pypi.org/trusted-publishers/)发布到PyPI，因此无需在任何地方存储令牌。
---
## 免责声明
> VeryChic MCP与VeryChic或VeryChic SAS无关，不受其支持或连接。它是一个独立的社区工具，供个人使用，通过与浏览器相同的方式读取VeryChic的公共Web API。你负责遵守VeryChic的销售条款，特别是关于知识产权和数据库生产者的特殊权利的第9条。请自担风险，仅用于个人和低容量浏览。不要用于批量提取或VeryChic数据的重新分发。
## 许可证
MIT。参见[LICENSE](LICENSE)。
