内容
# wolt-mcp
<p align="center">
<img src="https://raw.githubusercontent.com/mekedron/wolt-cli/main/assets/logo.png" alt="wolt-mcp — Wolt MCP server for Claude Desktop, Claude Code, and Cursor" width="160" />
</p>
<p align="center">
<strong>一个非官方的 <a href="https://modelcontextprotocol.io">模型上下文协议</a> (MCP) 服务器，适用于 <a href="https://wolt.com">Wolt</a>。</strong><br />
可与 Claude Desktop、Claude Code、Cursor、Continue、Zed 以及其他任何 MCP 主机连接。
</p>
---
> ### 📦 代码位于 **[`mekedron/wolt-cli`](https://github.com/mekedron/wolt-cli)**
>
> `wolt-mcp` 作为一个独立的二进制文件，与 [`wolt-cli`](https://github.com/mekedron/wolt-cli) 仓库中的 `wolt` 命令行工具一起构建和发布。它们共享 100% 的网关、身份验证和服务代码。
>
> **有关源代码、安装、问题、发布和完整文档，请访问**
> **→ [github.com/mekedron/wolt-cli](https://github.com/mekedron/wolt-cli)**
>
> 该仓库的存在是为了让搜索 *"wolt mcp"*、*"wolt mcp server"*、 *"wolt model context protocol"* 或 *"wolt claude desktop"* 的人能够找到正确的位置。
---
## 什么是 wolt-mcp？
`wolt-mcp` 是一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，为 [Wolt](https://wolt.com) 食品配送提供了一个类型化的、模式描述的工具表面。通过配置 `wolt-mcp`，AI 客户端可以：
- 浏览 Wolt 发现频道，并排名附近的热门场馆
- 按名称、类别、评分或费用搜索餐厅和杂货店
- 读取场馆的菜单、营业时间、商品详情和选项矩阵
- 查看您的订单历史、保存的地址和支付方式
- 管理您的购物车（添加、删除、清空）并预览结账总额
- 收藏或取消收藏场馆
… 所有这些都无需模型构造标志或使用命令行界面。
它 **与 Wolt 无关**。请自行承担使用风险。
## 支持的 MCP 客户端
`wolt-mcp` 支持 stdio MCP，因此它与所有现代 MCP 主机兼容：
- **Claude Desktop**（macOS、Windows）
- **Claude Code**（Anthropic 的官方命令行界面）
- **Cursor**
- **Continue**（VS Code、JetBrains）
- **Zed**
- 任何其他支持 `mcpServers` 配置形状的客户端
## 快速入门
### 1. 安装
`wolt-mcp` 包含在与 `wolt` 命令行工具相同的 Homebrew 软件包中：
```bash
brew install mekedron/tap/wolt-cli # 同时安装 `wolt` 和 `wolt-mcp`
```
从源代码安装：
```bash
go install github.com/mekedron/wolt-cli/cmd/wolt-mcp@latest
```
验证：
```bash
wolt-mcp --version
```
### 2. 连接到您的 MCP 客户端
相同的单行配置在每个通过 stdio 支持 MCP 的客户端中都有效：
```json
{
"mcpServers": {
"wolt": { "command": "wolt-mcp" }
}
}
```
每个客户端的配置路径：
| 客户端 | 配置文件 |
|---|---|
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Claude Code | `.mcp.json`（项目）或 `~/.claude.json`（全局） |
| Cursor | `~/.cursor/mcp.json` |
| Continue、Zed、其他 stdio MCP 主机 | 相同的 `mcpServers` 形状 — 请参阅客户端文档 |
如果您的桌面客户端未继承您的 shell `$PATH`，请使用绝对路径（`which wolt-mcp` → 例如 `/opt/homebrew/bin/wolt-mcp`）。
完整的客户端设置、区域锁定、环境变量和故障排除： **[wolt-cli/docs/mcp.md](https://github.com/mekedron/wolt-cli/blob/main/docs/mcp.md)**。
### 3. 身份验证
`wolt-mcp` 与 `wolt` 命令行工具共享其会话。只需登录一次：
```bash
wolt login
```
MCP 服务器会自动读取和轮换 `~/.wolt/.wolt-config.json` 中的相同令牌。身份验证门控工具（购物车、收藏、帐户、结账预览）在您登录之前将返回一条清晰的“运行 `wolt login`…” 消息。
## 工具目录
v1 中的 24 个工具。✓ = 只读，⚠ = 修改用户状态。
### 发现（无需身份验证）
| 工具 | 目的 |
|---|---|
| `wolt_feed` ✓ | 按章节分组的发现首页 |
| `wolt_top` ✓ | 某个位置的热门场馆，带有排序/筛选 |
| `wolt_search_venues` ✓ | 搜索场馆，带有类别、开放时间、Wolt+、评分、费用筛选 |
| `wolt_venue_categories` ✓ | 某个位置的可用类别_slug |
| `wolt_resolve_address` ✓ | 将自由格式地址转换为纬度/经度 |
### 场馆（无需身份验证）
| 工具 | 目的 |
|---|---|
| `wolt_venue_detail` ✓ | 地址、评分、配送方式、营业窗口、标签 |
| `wolt_venue_menu` ✓ | 浏览场馆的菜单（分页、可筛选） |
| `wolt_venue_hours` ✓ | 场馆时区内的营业窗口 |
| `wolt_venue_item` ✓ | 某个商品的完整有效载荷（价格、选项、售罄） |
| `wolt_venue_search_items` ✓ | 场馆内的自由文本商品搜索 |
### 账户（需要身份验证）
| 工具 | 目的 |
|---|---|
| `wolt_account_status` ✓ | 当前用户配置文件 |
| `wolt_account_orders` ✓ | 分页订单历史 |
| `wolt_account_order` ✓ | 某个订单的完整详情 |
| `wolt_account_addresses` ✓ | 保存的配送地址 |
| `wolt_account_payments` ✓ | 保存的支付方式 |
### 收藏（需要身份验证）
| 工具 | 目的 |
|---|---|
| `wolt_favorites_list` ✓ | 已收藏的场馆 |
| `wolt_favorites_add` ⚠ | 将场馆添加到收藏 |
| `wolt_favorites_remove` ⚠ | 从收藏中删除场馆 |
### 购物车 + 结账（需要身份验证）
| 工具 | 目的 |
|---|---|
| `wolt_cart_show` ✓ | 所有购物车，包含商品行和总额 |
| `wolt_cart_count` ✓ | 所有购物车中的商品总数 |
| `wolt_cart_add` ⚠ | 将商品添加到购物车 |
| `wolt_cart_remove` ⚠ | 从购物车中删除商品行 |
| `wolt_cart_clear` ⚠ | 删除用户的所有购物车 |
| `wolt_checkout_preview` ✓ | 预览总额，无需下单 |
> **没有工具会下实际订单。** 最终结账仍在官方 Wolt 应用或网页界面中进行。`wolt_checkout_preview` 仅为价格预览。
完整的输入/输出模式和每个工具的示例位于 **[wolt-cli/docs/mcp.md](https://github.com/mekedron/wolt-cli/blob/main/docs/mcp.md)**。
## 为什么使用 MCP 服务器而不是“直接调用命令行界面”？
- 模型获得 **JSON-Schema 类型输入**，适用于每个工具，因此它停止构造标志组合。
- 错误 **在带内返回**（例如，“Wolt 会话已过期或丢失。请运行 `wolt login`…”）- 模型自我纠正而不是静默失败。
- **一个 stdio 进程**，适用于每个主机会话，而不是每个 CLI 调用一个子进程。
- 定价预览、购物车操作和订单历史都作为类型化工具可寻址，因此代理可以本地推理“当前我的购物车中有什么？”。
## 常见问题
### `wolt-mcp` 是官方的吗？
不。这是一个非官方的社区项目。它不被 Wolt Enterprises Oy 认可、赞助或附属。
### 它在哪些国家/地区有效？
Wolt 运营的任何市场。默认区域设置是 `en-FI`（英语副本，芬兰市场）。设置 `--locale fi-FI`、 `--locale et-EE`、 `--locale de-DE`、 `--locale sv-FI` 等，或 `WOLT_LOCALE=<bcp47>` 用于其他市场。
### `wolt-mcp` 会下真实订单吗？
不。MCP 服务器可以建立购物车并预览结账总额，但最终下单仍在官方 Wolt 应用或网页界面中进行。这是故意设置的保护措施 — 您不应让 LLM 在无人监督的情况下向支付处理器提交资金。
### 身份验证如何工作？
`wolt-mcp` 与 `wolt` 命令行工具共享 `~/.wolt/.wolt-config.json`。运行 `wolt login` 一次，两个二进制文件继承相同的会话。刷新令牌轮换在 MCP 服务器内部处理 — 在 `401` 时，服务器刷新并重试原始调用一次。
### 它使用什么传输？
仅限 v1 的 stdio MCP，这是所有现代桌面 MCP 主机（Claude Desktop、Claude Code、Cursor、Continue、Zed）所支持的。
### 它基于哪个 MCP SDK？
官方 Anthropic Go SDK： [`github.com/modelcontextprotocol/go-sdk`](https://github.com/modelcontextprotocol/go-sdk)。
### 在哪里提交错误或功能请求？
在主仓库中： **[github.com/mekedron/wolt-cli/issues](https://github.com/mekedron/wolt-cli/issues)**。
---
## 其他内容都在主仓库中
### → **[github.com/mekedron/wolt-cli](https://github.com/mekedron/wolt-cli)**
其中包括：
- `wolt-mcp` 的源代码 ([`cmd/wolt-mcp/`](https://github.com/mekedron/wolt-cli/tree/main/cmd/wolt-mcp)， [`internal/mcpserver/`](https://github.com/mekedron/wolt-cli/tree/main/internal/mcpserver))
- 与 `wolt` 命令行工具共享相同身份验证、网关和服务代码的 `wolt` 命令行工具
- 完整的 MCP 设置和工具参考： [`docs/mcp.md`](https://github.com/mekedron/wolt-cli/blob/main/docs/mcp.md)
- 完整的命令行工具参考： [`docs/commands.md`](https://github.com/mekedron/wolt-cli/blob/main/docs/commands.md)
- JSON/YAML 输出合同： [`docs/output-contract.md`](https://github.com/mekedron/wolt-cli/blob/main/docs/output-contract.md)
- 发布、Homebrew Tap、CI 和贡献指南
## 许可证
MIT — 请参阅 [wolt-cli 中的 LICENSE](https://github.com/mekedron/wolt-cli/blob/main/LICENSE)。
## 版权
版权 (c) 2026 Nikita Rabykin。与 Wolt 无关。
