Skip to main content
Glama
deenesjakoruzh
fliptheweb

FatSecret MCP Server

by fliptheweb
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

FatSecret MCP Server

[!IMPORTANT] 이것은 FatSecret의 공식 MCP 서버가 아닙니다. FatSecret Platform API를 사용하며, 무료 개발자 계정이 필요합니다.

Claude/Cursor를 FatSecret Platform API에 연결하는 MCP(Model Context Protocol) 서버입니다. AI 어시스턴트에서 직접 음식 검색, 식단 기록, 레시피 관리, 체중 모니터링을 할 수 있습니다.

NPM에서 사용 가능: npx fatsecret-mcp | Claude Desktop 확장 프로그램: fatsecret-mcp.mcpb

✨ 기능

  • 🔐 인증 — 대화형 자격 증명 설정 및 OAuth 인증

  • 🔍 음식 검색 — 상세 영양 데이터와 함께 FatSecret의 방대한 음식 데이터베이스 검색

  • 📷 바코드 조회 — GTIN-13 바코드로 음식 찾기

  • 🍳 레시피 검색 — 칼로리, 매크로, 조리 시간으로 레시피 검색 및 필터링

  • 📝 음식 일기 — 음식 일기 항목 추가, 편집, 복사, 삭제

  • 🍽️ 저장된 식사 — 재사용 가능한 식사 템플릿 생성 및 관리

  • ⚖️ 체중 추적 — 체중 기록 및 기록 조회

  • 🏃♂️ 운동 추적 — 운동 조회 및 활동 항목 관리

  • ⭐ 즐겨찾기 — 즐겨찾는 음식 및 레시피 관리

Related MCP server: fatsecret-mcp-server

🚀 빠른 시작

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. 다음 세 가지 값이 표시됩니다:

    • Client ID (OAuth 2.0 및 OAuth 1.0 모두에 사용)

    • Client Secret (OAuth 2.0 - 공개 음식/레시피 검색용)

    • Consumer Secret (OAuth 1.0 - 사용자 프로필/일기 액세스용)

📖 단계별 가이드: FatSecret API 시작하기

Claude Desktop (확장 프로그램)

Claude Desktop으로 fatsecret-mcp.mcpb를 다운로드하여 열면 FatSecret 자격 증명을 입력하라는 메시지가 표시됩니다. 자격 증명은 OS 키체인에 안전하게 저장됩니다.

자세한 내용은 MCPB로 데스크톱 확장 프로그램 빌드를 참조하세요.

Claude Desktop (수동)

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

Claude Code (CLI)

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

또는 환경 변수 사용:

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로 확인하세요.

Cursor

  • 설정 UI — Settings → MCP → + Add new MCP server, 그런 다음 명령, 인수, env를 입력합니다.

  • 프로젝트 구성 — 프로젝트 루트의 .cursor/mcp.json에 JSON을 추가합니다.

  • 전역 구성 — ~/.cursor/mcp.json에 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 Postman Collection

🧪 테스트 연결

npx fatsecret-mcp

또는 환경 변수 사용:

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

📋 요구 사항

  • Node.js 18+

  • FatSecret Platform API 계정 (platform.fatsecret.com)

  • MCP 호환 클라이언트 (Claude Desktop, Cursor 등)

🔧 개발

  1. 저장소를 클론합니다

  2. npm install

  3. .env.example을 .env로 복사하고 자격 증명을 입력합니다

  4. 개발 모드로 실행하려면 npm run dev

MCP Inspector로 디버깅:

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

📄 라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요.

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
7wRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Spoonacular

    Spoonacular food API: recipes, nutrition, ingredients, meal plans. Free 150/day.

  • openfoodfacts-mcp-server

    Barcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products.

  • Nutrition MCP

    Personal nutrition tracking — log meals, track macros, review history, import from another app.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fliptheweb/fatsecret-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server