USDA Nutrition Mcp Server

MCP其他

提供方 zen-apps

其他 未标注 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorCodex

Professional MCP server providing access to 600k+ foods from USDA FoodData Central. Features dual architecture (MCP + HTTP API), three deployment options (hosted/local/custom), and production-ready tools for nutrition analysis, food comparison, and dietary planning.

一句话选型结论

按资料字段整理

USDA Nutrition Mcp Server 属于其他类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类其他 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

其他
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

nutrition food health usda api production python fastapi

支持客户端

适用场景

nutritionfoodhealth

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
接入外部数据

把外部系统的数据接进对话。

自动化重复操作

把固定步骤交给模型跑。

补充工具能力

给模型补上它原本没有的能力。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在其他场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
USDA Nutrition Mcp Server当前 未标注 未标注 未标注 无 未标注
gemini-cli 未标注 stdio · 本地进程 本地部署 有 2026-04-13
ext-apps 未标注 stdio · 本地进程 本地部署 有 2026-04-19
northcinder 未标注 stdio · 本地进程 本地部署 有 2026-08-23
fastctx 未标注 stdio · 本地进程 本地部署 有 2026-08-23
quickstart-resources 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

其他
字段来自项目仓库与公开索引,中文说明由本站标注
提供方zen-apps上游标注的维护方 zen-apps
分类其他本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

6.9 KB
来自项目仓库与上游目录的原文,未做删改

🥗 USDA Nutrition MCP Enabled Server

> Professional Model Context Protocol (MCP) enabled server for USDA FoodData Central
> Transforms 600k+ foods into intelligent nutrition tools for Claude Desktop and other MCP clients

🌟 What This Demonstrates

This project showcases professional MCP implementation skills:

✅ Dual Architecture - Both MCP protocol server AND HTTP API
✅ Production Bridge - Smart mcp_bridge.py with hosted/local/custom server support
✅ Three Deployment Options - Hosted service, local development, custom server
✅ Type-Safe Models - Pydantic schemas with proper validation
✅ Docker + Cloud Run - Complete deployment pipeline

🚀 Quick Start for Claude Desktop

Option 1: Minimal Installation (Recommended)

Download just the bridge file - no need to clone the entire repository:```bash

Download the bridge

wget https://raw.githubusercontent.com/zen-apps/mcp-nutrition-tools/main/src/mcp_bridge.py

Install dependencies

pip install mcp httpx


Then add to your Claude Desktop config:```json
{
  "mcpServers": {
    "usda-nutrition": {
      "command": "python3",
      "args": ["/path/to/downloaded/mcp_bridge.py"]
    }
  }
}

Mac Users with Virtual Environment```bash

Navigate to your project

cd /Users/yourusername/your-project-folder

Create new venv in the project folder

python3 -m venv venv

Activate it

source venv/bin/activate

Install dependencies

pip install mcp httpx

Test it works

python src/mcp_bridge.py --server-url https://usda-nutrition-mcp-356272800218.us-central1.run.app


### Option 2: Full Repository (For Development)```json
{
  "mcpServers": {
    "usda-nutrition": {
      "command": "python3",
      "args": ["/path/to/mcp-nutrition-tools/src/mcp_bridge.py"],
      "cwd": "/path/to/mcp-nutrition-tools"
    }
  }
}

Option 2: Local Development```json

{
"mcpServers": {
"usda-nutrition": {
"command": "python3",
"args": [
"/path/to/mcp-nutrition-tools/src/mcp_bridge.py",
"--server-url",
"http://localhost:8080"
],
"cwd": "/path/to/mcp-nutrition-tools"
}
}
}


### Option 3: Custom Server```json
{
  "mcpServers": {
    "usda-nutrition": {
      "command": "python3",
      "args": [
        "/path/to/mcp-nutrition-tools/src/mcp_bridge.py",
        "--server-url",
        "https://your-server.com"
      ],
      "cwd": "/path/to/mcp-nutrition-tools"
    }
  }
}

See examples/configs/claude_desktop_config_examples.json for detailed configuration examples.

🔧 For Non-Claude Desktop Users

Direct HTTP API

Live API: https://usda-nutrition-mcp-oc46l7ob5a-uc.a.run.app
Documentation: https://usda-nutrition-mcp-oc46l7ob5a-uc.a.run.app/docs```bash

Search foods

curl -X POST "https://usda-nutrition-mcp-oc46l7ob5a-uc.a.run.app/tools/search_foods" \
-H "Content-Type: application/json" \
-d '{"query": "chicken breast", "page_size": 5}'

Get nutrition details

curl -X POST "https://usda-nutrition-mcp-oc46l7ob5a-uc.a.run.app/tools/get_food_nutrition" \
-H "Content-Type: application/json" \
-d '{"fdc_id": 171688}'


See API_USAGE.md for complete integration examples with Python, JavaScript, LangChain, and OpenAI.

## 🛠 MCP Tools Available

Once configured, Claude Desktop gets these nutrition tools:

- **`search_foods`** - Search USDA database by text
- **`get_food_nutrition`** - Get detailed nutrition for specific food
- **`compare_foods`** - Compare nutrition between multiple foods

### Example Claude Interaction

**You:** *"Compare the protein content of chicken breast vs salmon"*

**Claude:** *Uses MCP tools automatically:*
1. `search_foods("chicken breast")` → Finds FDC ID 171077
2. `search_foods("salmon")` → Finds FDC ID 175167
3. `compare_foods([171077, 175167])` → Gets comparison data
4. Provides detailed analysis with recommendations

## 🏗 Architecture Deep Dive

### Dual Server Design```
Claude Desktop ←→ mcp_bridge.py ←→ HTTP API ←→ USDA FoodData Central
     (MCP)              ↑              ↑              ↑
                   Smart Bridge    FastAPI       Rate Limited
                                                   Client

Key Implementation Details:
- src/mcp_server.py - FastMCP protocol server
- src/mcp_http_server.py - FastAPI HTTP server
- src/mcp_bridge.py - Smart bridge with server auto-detection
- src/usda_client.py - API client with retry logic
- src/models/ - Type-safe Pydantic schemas

Smart Bridge Logic

The bridge automatically detects server type and provides appropriate user feedback:```python

Hosted service detection

if "usda-nutrition-mcp-oc46l7ob5a-uc.a.run.app" in args.server_url:
print("🌐 Using hosted service (1,000 requests/hour shared)")

Local development

elif "localhost" in args.server_url:
print("🏠 Using local server (requires your USDA API key)")


## 📦 Installation & Development```bash
# Clone and setup
git clone https://github.com/zen-apps/mcp-nutrition-tools
cd mcp-nutrition-tools
pip install -r requirements.txt

# Get USDA API key (for local development)
# Visit: https://fdc.nal.usda.gov/api-guide.html
echo "FDC_API_KEY=your_key_here" > .env

# Test MCP server
python -m src.mcp_server

# Test HTTP server
python -m src.mcp_http_server

# Run tests
python -m pytest tests/ -v

# Code quality
ruff check src/
ruff format src/
mypy src/

🐳 Deployment Options

Local Development```bash

Run HTTP server locally

python -m src.mcp_http_server

Run with Docker

make up


### Production Deployment```bash
# Deploy to Google Cloud Run
export FDC_API_KEY="your_usda_key"
./scripts/deploy-gcp.sh

The production deployment includes:
- Automatic SSL/HTTPS
- Health checks and monitoring
- Auto-scaling based on demand
- Structured logging

🔑 Configuration

Environment Variables

  • FDC_API_KEY - USDA FoodData Central API key (required for local)
  • ENVIRONMENT - "development" or "production"
  • LOG_LEVEL - Logging level (DEBUG, INFO, etc.)

Rate Limits

  • Hosted Service: 1,000 requests/hour (shared)
  • Local Deployment: 1,000 requests/hour (your key)
  • Enterprise: Contact for higher limits

🧪 Testing Strategy```bash

Quick connectivity test

python test_quick.py

Full test suite with mocking

python -m pytest tests/ -v

Test specific MCP tools

python examples/live_demo.py
```

The test suite includes:
- USDA API mocking with httpx-mock
- Async MCP server testing
- Integration test examples
- Performance benchmarking

🤝 Contributing

  1. Fork the repository
  2. Create feature branch: git checkout -b feature/amazing-feature
  3. Run tests: python -m pytest tests/
  4. Run linting: ruff check src/
  5. Submit pull request

📄 License

MIT License - see LICENSE file for details.


🎯 Ready to use? See examples/configs/claude_desktop_config_examples.json for setup instructions!

🔗 Live API: https://usda-nutrition-mcp-oc46l7ob5a-uc.a.run.app/docs

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
USDA Nutrition Mcp Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

USDA Nutrition Mcp Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

USDA Nutrition Mcp Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

USDA Nutrition Mcp Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

USDA Nutrition Mcp Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

USDA Nutrition Mcp Server 能提供哪些能力?

资料显示能力标签包括 nutrition、food、health、usda、api、production。具体工具清单以官方文档为准。

USDA Nutrition Mcp Server 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。