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 资源和工具时，可根据实际需求调整查询参数，以获取更精准的信息。例如，在搜索食物时，可指定数据类型、品牌所有者等参数。