Victualia MCP

MCP运维云端

提供方 dagnele

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

Victualia MCP服务器是一个用于动态获取Victualia API的OpenAPI规范并将其暴露为MCP工具的服务,使AI助手能够代表用户与Victualia API交互。

一句话选型结论

按资料字段整理

Victualia MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

家庭管理TypeScript本地部署API代理AI集成自动化工具OpenAPI

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -e VICTUALIA_API_KEY=your-api-key ghcr.io/dagnele/victualia-mcp:latest

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Victualia MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方dagnele上游标注的维护方 dagnele
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.9 KB
来自项目仓库与上游目录的原文,未做删改

食品mcp

MCP(模型上下文协议)服务器 受害者 API

什么是受害者?

受害者-你的家,有组织的

Victualia是一款生活方式应用程序,可帮助您组织家庭、跟踪家居用品、计划膳食和有效管理生活。可在Web、iOS和Android上使用。

主要特点

  • 房屋库存跟踪 -追踪从食品储藏室到车库的所有东西
  • 条形码扫描 -使用Open Food Facts数据库快速添加项目
  • 人工智能驱动的膳食计划 -根据您的喜好和可用食材获得个性化的用餐建议
  • 自动生成的购物清单 -永远不要忘记你需要什么
  • 配方管理和导入 -从任何网站导入食谱或创建自己的食谱
  • 到期日期提醒 -通过及时通知减少食物浪费
  • 多家庭支持 -从一个帐户管理多个属性
  • 多地点组织 -按位置组织物品(餐具室、冰箱、车库等)

支持的语言

英语、西班牙语、意大利语、德语、法语和葡萄牙语。

这个MCP服务器做什么?

该服务器动态地从Victuaria获取OpenAPI规范,并将所有API端点公开为MCP工具,允许AI助手(Claude、OpenCode、Cursor等)代表您与Victualia API交互。

使用此MCP服务器,您可以要求您的AI助手:

  • 检查你的餐具室里有什么东西
  • 将商品添加到购物清单中
  • 获取膳食计划建议
  • 跟踪过期项目
  • 管理你的食谱
  • 还有更多!

安装选项

选项1:npx(推荐-不安装)```bash

VICTUALIA_API_KEY=your-api-key npx victualia-mcp


### 选项2:全局npm安装```bash
npm install -g victualia-mcp
victualia-mcp

选项3:独立二进制

从以下网址下载适用于您平台的预构建二进制文件 发布 页面:

平台 二进制
Linux(x64) victualia-mcp-linux-x64
macOS(英特尔) victualia-mcp-darwin-x64
macOS(苹果硅) victualia-mcp-darwin-arm64
Windows(x64) victualia-mcp-windows-x64.exe
# Linux/macOS
chmod +x victualia-mcp-linux-x64
./victualia-mcp-linux-x64

# Windows
victualia-mcp-windows-x64.exe

选项4:Docker```bash

docker run -e VICTUALIA_API_KEY=your-api-key ghcr.io/dagnele/victualia-mcp:latest


或者使用Docker Compose:```yaml
services:
victualia-mcp:
image: ghcr.io/dagnele/victualia-mcp:latest
environment:
- VICTUALIA_API_KEY=your-api-key

获取API密钥

API访问需要 保费账户 (9.99欧元/月)。

获取API密钥:

  1. 首选 食物app 并注册或登录
  2. 订阅高级计划
  3. 导航至 设置 > API密钥
  4. 生成一个新的API密钥并复制它

请确保API密钥的安全,切勿公开共享。

配置

服务器是通过环境变量配置的:

变量 描述 默认值
VICTUALIA_API_KEY 用于身份验证的API密钥 (必需)
VICTUALIA_API_URL API请求的基本URL https://www.victualia.app/api/v1
VICTUALIA_OPENAPI_URL 获取OpenAPI规范的URL https://www.victualia.app/api/v1/openapi.json

使用AI助手

克劳德桌面版

添加到您的Claude Desktop配置中:

  • Linux: ~/.config/claude/claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: `%APPDATA%\Claude\claude_desktop_config.json````json
    {
    "mcpServers": {
    "victualia": {
    "command": "npx",
    "args": ["-y", "victualia-mcp"],
    "env": {
    "VICTUALIA_API_KEY": "your-api-key-here"
    }
    }
    }
    }

或者使用独立二进制文件:```json
{
"mcpServers": {
"victualia": {
"command": "/path/to/victualia-mcp-linux-x64",
"env": {
"VICTUALIA_API_KEY": "your-api-key-here"
}
}
}
}

OpenCode

添加到您的 opencode.json:```json
{
"mcp": {
"victualia": {
"command": "npx",
"args": ["-y", "victualia-mcp"],
"env": {
"VICTUALIA_API_KEY": "your-api-key-here"
}
}
}
}


### 光标

添加到光标MCP设置中:```json
{
"mcpServers": {
"victualia": {
"command": "npx",
"args": ["-y", "victualia-mcp"],
"env": {
"VICTUALIA_API_KEY": "your-api-key-here"
}
}
}
}

内置工具

除了动态生成的API工具外,服务器还提供:

工具 说明
list_endpoints 列出所有可用的Victualia API端点
api_info 获取有关受害者API的信息

运作原理

  1. 启动时,服务器从Victualia获取OpenAPI规范
  2. 每个API端点都转换为一个MCP工具,具有:
    - 操作ID作为工具名称
    - 路径、查询和标头参数作为工具参数
    - 请求对POST/PUT/PATCH方法的主体支持
  3. 当调用一个工具时,服务器向Victualia API发出相应的HTTP请求
  4. 响应以JSON格式返回

发展

需求

  • 包子 v1.0.0或更高版本

设置```bash

git clone https://github.com/dagnele/victualia-mcp.git
cd victualia-mcp
bun install


### 命令```bash
# Run in development mode with hot reload
bun run dev

# Type check
bun run typecheck

# Build for npm distribution
bun run build

# Build standalone binary (current platform)
bun run build:binary

# Build binaries for all platforms
bun run build:all

# Run locally
bun start

Docker构建```bash

docker build -t victualia-mcp .
docker run -e VICTUALIA_API_KEY=your-key victualia-mcp


## 出版

### 自动发布

当您推送版本标签时,发布会自动发生:```bash
git tag v1.0.0
git push origin v1.0.0

这将:

  1. 为所有平台构建二进制文件
  2. 发布到npm
  3. 将Docker镜像推送到GitHub容器注册表
  4. 创建包含二进制下载的GitHub版本

手工出版```bash

npm publish
```

GitHub操作设置

要启用自动发布,请将以下机密添加到您的存储库中:

机密 描述
NPM_TOKEN 用于发布的npm访问令牌
DOCKERHUB_USERNAME (可选)Docker Hub用户名
DOCKERHUB_TOKEN (可选)Docker Hub访问令牌

链接

  • 受害者应用程序 -受害者申请
  • GitHub存储库 -源代码和问题
  • npm包 -npm包

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Victualia MCP 怎么安装?

在客户端按下面的安装命令接入:docker run -e VICTUALIA_API_KEY=your-api-key ghcr.io/dagnele/victualia-mcp:latest。装完在客户端配置里引用同一个包或端点。

Victualia MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Victualia MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Victualia MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Victualia MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Victualia MCP 能提供哪些能力?

资料显示能力标签包括 API代理、TypeScript、Claude、API集成。具体工具清单以官方文档为准。

Victualia MCP 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Victualia MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。