Food Data Central MCP Server

🚀 美國農業部食品數據中央 MCP 服務器

這是一個模型上下文協議（MCP）服務器，用於通過 API 訪問 美國農業部的食品數據中央 API，能幫助用戶便捷地獲取美國農業部食品數據中央的相關信息。

🚀 快速開始

本 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 搜索食物、獲取營養信息或檢索詳細的食物數據。

高級用法

使用 MCP 資源獲取信息

使用 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

使用 MCP 工具搜索食物

{
  "name": "search-foods",
  "arguments": {
    "query": "apple",
    "dataType": ["Foundation", "SR Legacy"],
    "pageSize": 10,
    "pageNumber": 1,
    "brandOwner": "",
    "tradeChannel": "",
    "startDate": "2023-01-01",
    "endDate": "2023-12-31"
  }
}

📚 詳細文檔

MCP 資源和工具

資源

• food://details - 獲取特定食品的詳細信息（ID）
  • 查詢參數：
    • fdcId: 食品數據中央 ID（必需）
    • format: 可選。'abridged' 表示縮略版本，'full' 表示所有元素（默認）
    • nutrients: 可選。最多 25 個營養素編號列表（逗號分隔）
• food://foods - 使用輸入的 FDC ID 獲取多個食品的詳細信息
  • 查詢參數：
    • fdcIds: 以逗號分隔的字符串，包含一個或多個 FDC IDs
• food://list - 獲取食品列表
  • 查詢參數：
    • dataType: 數據類型（例如 Foundation, SR Legacy）
    • pageSize: 每頁顯示的條目數
    • pageNumber: 當前頁碼

工具

• search-foods: 搜索食物
  • 參數：
    • query: 要搜索的食物名稱
    • dataType: 受支持的數據類型列表（例如 Foundation, SR Legacy）
    • pageSize: 每頁顯示的條目數
    • pageNumber: 當前頁碼
    • brandOwner: 特定品牌所有者（僅限品牌食品）
    • tradeChannel: 包含指定貿易渠道的食物
    • startDate: 發佈日期起始（格式：YYYY-MM-DD）
    • endDate: 發佈日期結束（格式：YYYY-MM-DD）

⚠️ 重要提示

如果您使用的是 Windows，在將食品數據中央 MCP 服務器添加到 Claude Desktop 配置文件時，可能需要調整 PATH 值以包含 npm 全局安裝目錄。

💡 使用建議

在使用 MCP 資源和工具時，可根據實際需求調整查詢參數，以獲取更精準的信息。例如，在搜索食物時，可指定數據類型、品牌所有者等參數。