Food Data Central MCP Server

🚀 米国農務省食品データセントラルMCPサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーであり、APIを通じて米国農務省の食品データセントラルAPIにアクセスするために使用されます。

✨ 主な機能

• USDA食品データセントラルデータベース内の食品を検索する
• 食品の栄養情報にアクセスする
• 結果をページングする
• 複数のデータタイプ（基礎、SR Legacy、調査、ブランド）をサポートする

📦 インストール

1. リポジトリをクローンする
2. 依存関係をインストールする：

   npm install
   

3. プロジェクトをビルドする：

   npm run build
   

🚀 クイックスタート

このサーバーはstdio転送を使用しており、MCPクライアントによって子プロセスとして実行されるように設計されています。直接実行するには：

# USDA APIキーを環境変数に設定する
export USDA_API_KEY=your-api-key-here
npm start

開発時にホットリロードを使用するには：

# USDA APIキーを環境変数に設定する
export USDA_API_KEY=your-api-key-here
npm run dev

Claude Desktopとの連携

このMCPサーバーをClaude Desktopと一緒に使用するには：

1. Claude Desktopの設定を開く：

   • macOSの場合：Claudeメニューをクリックし、「設定...」を選択する
   • Windowsの場合：Claudeメニューをクリックし、「設定...」を選択する

2. 設定ペインで、左側のバーの「開発者」をクリックし、「設定を編集」をクリックする

3. これにより、設定ファイルが作成または開かれます：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

4. 食品データセントラルMCPサーバーを設定ファイルに追加する：

   {
     "mcpServers": {
       "food-data-central": {
         "command": "npx",
         "args": ["tsx", "/path/to/food-data-central-mcp-server/src/index.ts"],
         "env": {
           "PATH": "/opt/homebrew/bin",
           "USDA_API_KEY": "<INSERT KEY HERE>"
         }
       }
     }
   }
   

   /path/to/food-data-central-mcp-server をリポジトリの実際の絶対パスに置き換え、 <INSERT KEY HERE> を実際のUSDA APIキーに置き換えてください。

   注意：Windowsを使用している場合は、PATH値を調整してnpmのグローバルインストールディレクトリを含める必要がある場合があります。

5. 設定ファイルを保存し、Claude Desktopを再起動する

6. 再起動後、入力ボックスの右下にハンマーアイコンが表示されます。これをクリックすると、利用可能なツールを表示できます。

これで、ClaudeはこのMCPサーバーを通じて食品データセントラルAPIにアクセスできるようになります。Claudeに食品の検索、栄養情報の取得、または詳細な食品データの検索を依頼することができます。

📚 ドキュメント

リソース

• food://details - 特定の食品の詳細情報を取得する（ID）

  • クエリパラメータ：
    • fdcId: 食品データセントラルID（必須）
    • format: オプション。'abridged' は省略版、'full' はすべての要素（デフォルト）
    • nutrients: オプション。最大25個の栄養素番号のリスト（カンマ区切り）

• food://foods - 入力されたFDC IDを使用して複数の食品の詳細情報を取得する

  • クエリパラメータ：
    • fdcIds: 1つ以上のFDC IDを含むカンマ区切りの文字列

• food://list - 食品リストを取得する

  • クエリパラメータ：
    • dataType: データタイプ（例：Foundation, SR Legacy）
    • pageSize: 1ページに表示する項目数
    • pageNumber: 現在のページ番号

ツール

• search-foods: 食品を検索する

  • パラメータ：
    • query: 検索する食品名
    • dataType: サポートされるデータタイプのリスト（例：Foundation, SR Legacy）
    • pageSize: 1ページに表示する項目数
    • pageNumber: 現在のページ番号
    • brandOwner: 特定のブランド所有者（ブランド食品のみ）
    • tradeChannel: 指定された貿易チャネルを含む食品
    • startDate: 公開日の開始（形式：YYYY-MM-DD）
    • endDate: 公開日の終了（形式：YYYY-MM-DD）

💻 使用例

基本的な使用法

MCPリソースを使用して食品の詳細情報を取得する：

food://details?fdcId=2345678&format=full

MCPリソースを使用して複数の食品の詳細情報を取得する：

food://foods?fdcIds=534358,373052,616350

MCPリソースを使用して食品リストを取得する：

food://list?dataType=Foundation,SR Legacy&pageSize=10&pageNumber=1