内容
odrive-MCP
一个 [MCP](https://modelcontextprotocol.io) 服务器，提供 [Chronodrive](https://www.chronodrive.com) 的购物车管理功能，作为适用于任何MCP兼容的LLM的工具。
通过与AI助手对话，搜索产品、将其添加到购物车并重置购物车。
## 工具列表
| 工具 | 描述 |
|---|---|
| `search` | 自由文本产品搜索。返回按Chronodrive自己的排名排序的顶部结果，包含价格和 |
| `add_to_cart` | 通过 `productId` 和数量将产品添加到购物车。 |
| `remove_from_cart` | 通过 `productId` 从购物车中删除特定产品。 |
| `get_cart` | 返回当前购物车内容 — 产品、数量和总计。 |
| `reset_cart` | 清空整个购物车。 |
| `auth` | 强制令牌续期（在401时自动调用）。 |
### `search` 响应字段
每个结果都包含：
- `name`、`brand`、`size`、`productId`
- `price 单位价格
- `pricePerKg` — 每公斤升的价格
- `stock` — `HIGH_STOCK`、`LOW_STOCK` 等
- `remainingStock` — 可用单位数量
- `flags` — `fresh`、`frozen`、`organic`、`french`
## 用例：基于餐食的杂货自动化
主要用例是让AI助手将每周餐食计划自动转换为填充的购物车。
提供您的食谱（作为文件、列表或在对话中），并要求它填充您的Chronodrive购物车。它将：
1. 从食谱中提取每个配料及其数量和单位
2. 为每个配料调用 `search`，选择最佳原始产品（新鲜、库存充足、尺寸合适）
3. 显示选择结果供您审查 — 在添加购物车之前，您可以更换任何物品
4. 为每个验证的产品调用 `add_to_cart`
示例提示：
```
以下是我的三餐计划：[四人份意大利面肉酱，四人份鸡肉炒菜，四人份扁豆汤]。
合并配料，在Chronodrive上搜索每个配料，并将它们添加到我的购物车中。
```
## 安装
**要求：** Python 3.11+，Chronodrive账户，您的商店ID。
```bash
git clone https://github.com/y-vex/chronodrive-mcp
cd chronodrive-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env # 填写您的凭证
```
您的商店ID在登录时出现在URL中：`chronodrive.com/store/XXXX`。
## 客户端配置
该服务器适用于任何MCP兼容的客户端：Claude Code、Claude Desktop、Cursor、Windsurf、Zed、ChatGPT 或使用MCP SDK构建的任何自定义代理。
每个客户端都有MCP服务器的方式。常见参数始终是：
- **command** — 虚拟环境中Python解释器的路径
- **args** — `server.py` 的路径
- **env** — 您的三个凭证（`CHRONODRIVE_EMAIL`、`CHRONODRIVE_PASSWORD`、`CHRONODRIVE_STORE_ID`）
**Claude Code** — 在项目目录中创建一个 `.mcp.json` 文件（保持其在git之外）：
```json
{
"mcpServers": {
chronodrive": {
"command": "/absolute/path/to/chronodrive-mcp/.venv/bin/python",
"args": ["/absolute/path/to/chronodrive-mcp/server.py"],
"env": {
"CHRONODRIVE_EMAIL": "your@email.com",
"CHRONODRIVE_PASSWORD": "yourpassword",
"CHRONODRIVE_STORE_ID": "1234"
}
}
}
}
```
**Claude Desktop** — 在 `~/Library/Application Support/Claude/claude_desktop_config.json` 中添加相同的区块。
**Cursor / Windsurf / Zed** — 参考每个编辑器的MCP文档；服务器命令和环境变量相同。
## 会话缓存
bearer令牌缓存在 `~/.chronodrive-mcp/session.json` 中，并在调用之间重复使用。401响应触发自动重新身份验证。可以使用RONODRIVE_SESSION_FILE` 覆盖路径。
## 法律
该项目使用Chronodrive的公共前端API（与网站使用的相同端点）。它不会抓取HTML或绕过任何访问控制。仅供您自己的帐户使用。请参阅Chronodrive的 [CGU](https://www.chronodrive.com) 以获取他们的服务条款。
