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. 以下の3つの値が表示されます:

   • クライアント ID（OAuth 2.0 と OAuth 1.0 の両方で使用）

   • クライアントシークレット（OAuth 2.0 - 公開食品/レシピ検索用）

   • コンシューマーシークレット（OAuth 1.0 - ユーザープロフィール/食事日記アクセス用）

📖 ステップバイステップガイド: FatSecret API 入門

Claude Desktop（拡張機能）

fatsecret-mcp.mcpb をダウンロードして Claude Desktop で開きます。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 — 設定 → MCP → + 新しい MCP サーバーを追加 でコマンド、引数、環境変数を入力

• プロジェクト設定 — プロジェクトルートの .cursor/mcp.json に JSON を追加

• グローバル設定 — ~/.cursor/mcp.json に JSON を追加

🛠️ 利用可能なツール

API リファレンス: FatSecret Postman コレクション

🧪 接続テスト

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 ファイルを参照してください。