食品数据中心 MCP 服务器

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

特征

该服务器使用 stdio 传输，这意味着它被设计为由 MCP 客户端作为子进程运行。要直接运行它：

# Set the USDA API key as an environment variable export USDA_API_KEY=your-api-key-here npm start

对于使用热重载进行开发：

# Set the USDA API key as an environment variable export USDA_API_KEY=your-api-key-here npm run dev

要将此 MCP 服务器与 Claude Desktop 一起使用：

打开 Claude 桌面设置：
- 在 macOS 上：单击 Claude 菜单并选择“设置...”
- 在 Windows 上：单击 Claude 菜单并选择“设置...”
在“设置”窗格中，单击左侧栏中的“开发人员”，然后单击“编辑配置”
这将在以下位置创建或打开一个配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows： %APPDATA%\Claude\claude_desktop_config.json
将 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 全局安装目录。
保存配置文件并重新启动Claude Desktop
重启后，您应该会在输入框右下角看到一个锤子图标。点击它即可查看可用的工具。

现在，Claude 将能够通过此 MCP 服务器访问食品数据中心 API。您可以让 Claude 搜索食品、获取营养信息或检索详细的食品数据。

food://details - 通过 ID 获取特定食物的详细信息
- 查询参数：
  - fdcId ：食品数据中心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"

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