AI导哈

FatSecret MCP 服务器

FatSecret MCP 服务器是一个连接 Claude/Cursor 和 FatSecret 平台 API 的 MCP（模型上下文协议）服务器，用于搜索食物、跟踪饮食、管理食谱和监测体重。

  • by fliptheweb
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 fliptheweb/fatsecret-mcp

使用说明

FatSecret MCP服务器

[！重要] 这是 不是官方MCP服务器 FatSecret。 它使用 FatSecret平台API 这需要一个免费的开发者帐户。

MCP（模型上下文协议）服务器，将Claude/Cursor连接到 FatSecret平台API.直接从您的AI助手搜索食物、跟踪您的饮食、管理食谱和监测体重。

在NPM上可用: npx fatsecret-mcp | Claude桌面扩展: 脂肪分泌-mcp.mcpb

✨ 特性

  • 🔐 认证 --交互式凭据设置和OAuth授权
  • 🔍 食品搜索 --使用详细的营养数据搜索FatSecret的广泛食品数据库
  • 📷 条形码查找 --通过GTIN-13条形码查找食物
  • 🍳 食谱搜索 --按卡路里、宏和准备时间浏览和过滤食谱
  • 📝 食物日志 --添加、编辑、复制和删除食物日记条目
  • 🍽️ 节省的饭菜 --创建和管理可重复使用的膳食模板
  • ⚖️ 重量追踪 --记录并查看体重历史记录
  • 🏃‍♂️ 运动追踪 --查看练习和管理活动条目
  • ⭐ 收藏夹 --管理喜爱的食物和食谱

🚀 快速开始

添加到MCP客户端配置中：

{
  "mcpServers": {
    "fatsecret": {
      "command": "npx",
      "args": ["-y", "fatsecret-mcp"]
    }
  }
}

就是这样！首次使用时，AI将指导您完成设置：

  1. check_auth_status -检测到丢失的凭据并告诉您要做什么
  2. setup_credentials -您提供API密钥（保存到 ~/.fatsecret-mcp/config.json)
  3. start_auth → complete_auth --授权您的FatSecret帐户使用日记/称重工具

或者，您可以将凭据作为环境变量传递：

{
  "mcpServers": {
    "fatsecret": {
      "command": "npx",
      "args": ["-y", "fatsecret-mcp"],
      "env": {
        "FATSECRET_CLIENT_ID": "your_client_id",
        "FATSECRET_CLIENT_SECRET": "your_client_secret",
        "FATSECRET_CONSUMER_SECRET": "your_consumer_secret"
      }
    }
  }
}

🔑 在哪里获取凭据

  1. 在以下网址创建免费帐户 platform.fatsecret.com
  2. 导航至 我的账户→ API密钥
  3. 您将看到三个值：
    • 客户端ID （用于OAuth 2.0和OAuth 1.0）
    • 客户端密钥 （OAuth 2.0-用于公共食品/食谱搜索）
    • 消费者秘密 （OAuth 1.0-用于用户配置文件/日记访问）

📖 分步指南： FatSecret API入门

克劳德桌面（扩展）

下载并打开 脂肪分泌-mcp.mcpb 克劳德桌面。系统将提示您输入FatSecret凭据——机密安全地存储在操作系统密钥链中。

看 使用MCPB构建桌面扩展 了解更多详情。

克劳德桌面（手册）

~/Library/Application Support/Claude/claude_desktop_config.json

克劳德代码（CLI）

claude mcp add fatsecret -- npx -y fatsecret-mcp

或者使用env变量：

claude mcp add fatsecret \
  -e FATSECRET_CLIENT_ID=your_client_id \
  -e FATSECRET_CLIENT_SECRET=your_client_secret \
  -e FATSECRET_CONSUMER_SECRET=your_consumer_secret \
  -- npx -y fatsecret-mcp

证实 claude mcp list.

光标

  • 设置UI — Settings → MCP → + Add new MCP server，然后填写命令、args和env
  • 项目配置 --将JSON添加到 .cursor/mcp.json 在项目根目录中
  • 全局配置 --将JSON添加到 ~/.cursor/mcp.json

🛠️ 可用工具

工具 说明
🔐 设置和验证
check_auth_status 检查是否配置了凭据和配置文件身份验证。 先叫这个。
setup_credentials 将FatSecret API凭据保存到持久配置
start_auth 启动OAuth 1.0授权——返回用户访问的URL
complete_auth 从授权页面使用验证器PIN完成OAuth
🔍 食品搜索 （公众）
search_foods 搜索食品数据库
get_food 获取食物的详细营养信息
find_food_by_barcode 通过GTIN-13条形码查找食物
autocomplete_foods 获取搜索自动完成建议
🍳 食谱 （公众）
search_recipes 使用过滤器搜索食谱
get_recipe 获取配方细节，包括配料和说明
📚 参考 （公众）
get_food_categories 获取食品类别
get_food_sub_categories 获取食品子类别
get_brands 获取食品品牌
get_recipe_types 获取食谱类型
📝 食物日志 （配置文件身份验证）
get_food_entries 获取日期的食物日记条目
get_food_entries_month 获取每月营养总结（每天的卡路里和宏量）
create_food_entry 添加食物日记条目
edit_food_entry 编辑食物日记条目
delete_food_entry 删除食物日记条目
copy_food_entries 将条目从一个日期复制到另一个日期
copy_saved_meal_entries 将保存的餐点复制到日期
⭐ 收藏夹 （配置文件身份验证）
get_favorite_foods 获取喜爱的食物
delete_favorite_food 从收藏夹中删除食物
get_most_eaten_foods 吃得最多的食物
get_recently_eaten_foods 获取最近吃过的食物
get_favorite_recipes 获取喜爱的食谱
add_favorite_recipe 将食谱添加到收藏夹
delete_favorite_recipe 从收藏夹中删除食谱
🍽️ 节省的饭菜 （配置文件身份验证）
get_saved_meals 获得节省的餐食
create_saved_meal 制作一顿节省的饭菜
edit_saved_meal 编辑已保存的餐点
delete_saved_meal 删除已保存的餐点
get_saved_meal_items 在节省的餐食中获取物品
add_saved_meal_item 在节省的饭菜中添加食物
edit_saved_meal_item 编辑已保存的餐点
delete_saved_meal_item 从已保存的餐食中删除项目
⚖️ 重量 （配置文件身份验证）
update_weight 记录日期的重量
get_weight_month 获取一个月的体重历史记录
🏃‍♂️ 锻炼 （配置文件身份验证）
get_exercises 获取运动类型
edit_exercise_entries 在活动之间调整锻炼时间
get_exercise_entries_month 获取一个月的运动数据
save_exercise_template 保存工作日的练习模板
👤 个人资料 （配置文件身份验证）
get_profile 获取用户资料信息
create_food 定制食物（Premier）

API参考： FatSecret邮差系列

🧪 测试连接

npx fatsecret-mcp

或者使用env变量：

FATSECRET_CLIENT_ID='...' FATSECRET_CLIENT_SECRET='...' FATSECRET_CONSUMER_SECRET='...' npx fatsecret-mcp

📋 需求

  • Node.js 18+
  • FatSecret平台API账户(platform.fatsecret.com)
  • MCP兼容客户端（克劳德桌面、光标等）

🔧 发展

  1. 克隆存储库
  2. npm install
  3. 复制 .env.example 到 .env 并填写您的凭据
  4. npm run dev 以开发模式运行

使用MCP检查器进行调试：

FATSECRET_CLIENT_ID=X FATSECRET_CLIENT_SECRET=X FATSECRET_CONSUMER_SECRET=X npx -y @modelcontextprotocol/inspector npx <local-path>/fatsecret-mcp

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

相关 MCP