内容
# 特斯科超市MCP服务器
一个[MCP](https://modelcontextprotocol.io)服务器，用于封装特斯科超市的购物API，允许像Claude这样的AI助手搜索产品、管理购物车和预订配送时段。
## 工具列表
### 身份验证
| 工具 | 描述 |
|------|-------------|
| `设置认证令牌` | 从浏览器会话中设置Bearer令牌和客户UUID |
### 搜索与浏览
| 工具 | 描述 |
|------|-------------|
| `搜索产品` | 搜索超市产品（支持批量多查询） |
| `获取产品详情` | 获取特定产品的详细信息 |
| `获取优惠` | 查找促销或俱乐部卡价的产品 |
| `获取替代品` | 查找不可用产品的替代品 |
| `浏览类别` | 获取部门/货架/货架分类树 |
| `获取收藏产品` | 获取您收藏的产品 |
| `获取订单历史` | 获取以前的订单 |
### 购物车
| 工具 | 描述 |
|------|-------------|
| `查看购物车` | 查看当前购物车内容 |
| `添加至购物车` | 添加产品或更改数量 |
| `从购物车移除` | 从购物车中移除产品 |
### 配送时段
| 工具 | 描述 |
|------|-------------|
| `获取配送时段` | 查看指定日期范围内的可用配送时段 |
| `获取可用周` | 查看哪些周有配送时段 |
| `获取当前时段` | 检查是否已预订时段 |
| `预订配送时段` | 预订或取消预订配送时段 |
## 前置条件
- Node.js >= 18
- 一个具有活跃超市会话的Tesco.com账户
## 安装
### 通过npx（推荐）
无需安装 — 只需配置您的MCP客户端（参见下文）。
### 全局安装
```bash
npm install -g tesco-grocery-mcp
```
### 从源码
```bash
git clone https://github.com/GavinAttard/tesco-grocery-mcp.git
cd tesco-grocery-mcp
npm install
npm run build
```
## 配置
### Claude Desktop
添加到您的`claude_desktop_config.json`：
```json
{
"mcpServers": {
"tesco-grocery": {
"command": "npx",
"args": ["-y", "tesco-grocery-mcp"]
}
}
}
```
### Claude 代码
```bash
claude mcp add tesco-grocery -- npx -y tesco-grocery-mcp
```
### 其他MCP客户端
在stdio上运行服务器：
```bash
npx -y tesco-grocery-mcp
```
或如果全局安装：
```bash
tesco-grocery
```
## 身份验证
服务器需要来自活跃的Tesco.com会话的Bearer令牌：
1. 在浏览器中登录[tesco.com/groceries](https://www.tesco.com/groceries/)
2. 打开开发者工具（F12）→ 网络选项卡
3. 找到任何请求到`xapi.tesco.com`的请求，并复制`Authorization`标头值和`x-customer-uuid`标头值，或从oAUTH.ACCESSTOKEN和UUID cookie中复制值
4. 使用`设置认证令牌`工具提供这些凭证
凭证本地持久化，因此您只需在会话过期时执行此操作。
参见[`.env.example`](.env.example)了解凭证格式。
## 购物技能
[`skills/SKILL.md`](skills/SKILL.md)文件包含一个优化的执行指南，教导AI助手如何高效地处理完整的每周购物 - 从搜索到购物车管理到配送时段预订。您可以使用它作为系统或参考自己的工作流程。
## 许可证
[MIT](LICENSE)
