Food Data Central MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，用于公开对 USDA FoodData Central API 的 API 访问。

功能

• 在 USDA Food Data Central 数据库中搜索食物
• 访问食物营养信息
• 分页结果
• 支持多种数据类型（基础、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. 将 Food Data Central 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 服务器访问 Food Data Central API。 您可以要求 Claude 搜索食物、获取营养信息或检索详细的食物数据。

MCP 资源和工具

资源

• food://details - 获取有关特定食物的详细信息（按 ID）

  • 查询参数：
    • fdcId：Food Data Central ID（必需）
    • format：可选。 'abridged' 表示简略元素集，'full' 表示所有元素（默认）
    • nutrients：可选。 最多 25 个营养编号的列表（逗号分隔）

• food://foods - 使用输入 FDC ID 获取多个食物项目的详细信息

  • 查询参数：
    • fdcIds：多个 FDC ID 的列表（必需，逗号分隔）
    • format：可选。 'abridged' 表示简略元素集，'full' 表示所有元素（默认）
    • nutrients：可选。 最多 25 个营养编号的列表（逗号分隔）

• food://list - 获取食物的分页列表

  • 查询参数：
    • dataType：可选。 筛选特定数据类型（逗号分隔列表）
    • pageSize：可选。 要返回的最大结果数（默认值：50）
    • pageNumber：可选。 要检索的页码（默认值：1）
    • sortBy：可选。 要排序的字段
    • sortOrder：可选。 排序顺序，“asc”或“desc”

工具

• search-foods - 使用关键字搜索食物
  • 参数：
    • query：查找食物的搜索词（必需）
    • dataType：可选。 筛选特定数据类型（字符串数组）
    • pageSize：可选。 要返回的最大结果数（默认值：50）
    • pageNumber：可选。 要检索的页码（默认值：1）
    • sortBy：可选。 要排序的字段
    • sortOrder：可选。 排序顺序，“asc”或“desc”
    • 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

使用 MCP 工具搜索食物：

{
  "name": "search-foods",
  "arguments": {
    "query": "apple",
    "dataType": ["Foundation", "SR Legacy"],
    "pageSize": 10,
    "pageNumber": 1
  }
}