官方说明7 个来源MCP 服务8 天前

dearlordylord/voila-sdk

Personal Voila groce

配置模板（请按你的客户端调整）

claude mcp add voila-sdk -- npx -y voila-sdk

这是根据仓库名生成的可粘贴骨架，命令行参数与包名请以该项目 README 为准。

★ 数取值: 0 ★ · dearlordylord/voila-sdk · 取自 GitHub 搜索 API · （2026-10-16 20:00:20 核对）
来源明细: 收录自 punkpeye/awesome-mcp-servers 榜单（我们从中收集的条目之一） · 条目类型：MCP 服务
收录与活跃: 收录于 2026-10-09 · 最近见到 2026-10-16 · 共见到 32 次 · 被 7 个来源列出
评分构成: 综合分 703 · 7 个来源 · mcp

常见问题（答案都来自我们的记录）

怎么安装？

我们【没有】从该仓库取到安装命令（我们的 install 覆盖率只有约 4%）。请看它的 README 或 releases 页。

它适合谁 / 用来做什么？

我们把它归在这些标签下: MCP 服务。标签来自条目自身，不是我们强加的分类。

谁维护它、还在更新吗？

仓库 dearlordylord/voila-sdk；我们收录于 2026-10-09；最近见到 2026-10-16。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。

第三方质量标记

Voila MCP

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

**Voila MCP** is a Model Context Protocol server for safe personal Voila grocery automation. It exposes small, auditable tools for product search, category browsing, discounts, delivery slots, cart deltas, and completed order history without exposing checkout or order placement.
Published on npm as @firfi/voila-mcp. The repository also includes @firfi/voila-sdk and @firfi/voila-cli.
Packages
- packages/voila-sdk: @firfi/voila-sdk, the TypeScript SDK for Voila sessions, search, categories, cart, order history, slots, and checkout-readiness helpers.
- packages/voila-mcp: @firfi/voila-mcp, a stdio MCP server exposing small auditable tools.
- packages/voila-cli: @firfi/voila-cli, a user CLI that reuses the MCP operation registry.
The root package is private. Publishable packages live under packages/.
MCP Setup
Voila does not publish a documented third-party customer API. This server uses the same same-origin JSON endpoints as the web app, so authenticated use is session-based. Capture a session interactively with the CLI; do not store a Voila password in MCP config.
If the session is missing, expired, or guest-only, tool results include authGuidance with the exact CLI login command to run. The MCP server itself does not launch a browser. A login performed while the server is running takes effect on its next tool call, without a restart.
With an explicit VOILA_AUTH_SESSION_PATH and guest mode off, the MCP server
also runs a read-only authenticated-session keepalive. Set VOILA_KEEPALIVE=0
to disable it; VOILA_KEEPALIVE_INTERVAL_SECONDS defaults to 86400 seconds
and must be at least 3600. The keepalive never bootstraps a guest and stops
as misconfigured if its configured session snapshot disappears.
Tools
- voila_check_session_health: report active, guest, expired, or retryable session state.
- voila_get_active_shopping_context: read current region, destination, delivery method, and cart context.
- voila_get_slot_listings: list delivery slots for an explicit destination and region.
- voila_reserve_slot: reserve a caller-selected slot only with explicit confirmation flags.
- voila_search_products: search products for the current session context.
- voila_get_category_products: fetch products for a Voila category id.
- voila_get_discounted_products: scan promotions and return meaningful discounted products.
- voila_get_completed_orders: read completed orders with cursor pagination.
- voila_get_order_details: read item-level details for one completed order.
- voila_get_completed_order_items: aggregate previously ordered items across completed orders.
- voila_get_cart: read active cart totals, limited items, unavailable data, and pricing notices.
- voila_add_cart_items: add quantity deltas using Voila product UUIDs.
- voila_remove_cart_items: remove quantity deltas using Voila product UUIDs.