Power your agent
URL ของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
https://usda.caseyjhand.com/mcpปุ่ม Claude ด้านบนจะเปิด Claude พร้อมกรอกชื่อและ URL ให้แล้ว คุณยังต้องยืนยันที่นั่นเอง
claude mcp add --transport http io.github.cyanheads-usda-mcp-server https://usda.caseyjhand.com/mcpRun in a terminal.
{ "mcpServers": { "io.github.cyanheads-usda-mcp-server": { "command": "npx", "args": [ "-y", "mcp-remote", "https://usda.caseyjhand.com/mcp" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดPublic Hosted Server: https://usda.caseyjhand.com/mcp
Nutrition data for roughly 400,000 foods from USDA FoodData Central, the US government's authoritative food composition database. Search by keyword or UPC, pull full nutrient profiles scaled to any portion, and compare foods side by side.
Food profiles and the nutrient reference are also reachable via tools. Use usda_search_foods to discover FDC IDs before reading food resources.
usda_search_foods tooldataType[] filter across SR Legacy, Foundation, Survey (FNDDS), and Branded, defaulting to ["SR Legacy"] (or ["Branded"] once brandOwner is set)brandOwner and foodCategory filters narrow results; pageSize (max 50, default 10) and pageNumber paginateusda_get_food for other nutrients or the full profiletotalPages returns empty foods[], the requested page, totals, and a notice with a valid pageNumber when the query has matchesquery_empty (blank query), query_syntax (FDC rejected the query syntax), no_results (nothing matched in the requested data sources)usda_get_food toolfdcId; optional nutrients[] filter to specific IDsunit (g / oz / lb / kg / serving) with an optional quantity scales every value from the FDC per-100g basis; quantity defaults to 100 for mass units and 1 for serving. Serving uses the first valid portion, or a positive finite Branded label size in g / GRM / GM (case-insensitive) when no portion exists, multiplied by quantityservingInfo identifies the resolved portion or label serving and its gram weight; allPortions[] contains actual portion definitions onlynot_found (bad FDC ID), quantity_without_unit, no_portion_data (no valid portion or supported Branded gram label). Volume, IU, milligram labels, missing units, and invalid sizes require an explicit mass-unit request; no density is inferredusda_get_foods toolnutrients[] filter strongly recommended — full profiles for 20 foods are largefailed[] instead of aborting the batchusda_compare_foods toolnutrients[] is givenquantity + unit basis (default 100 g; quantity is an amount in unit, so unit: "oz" alone compares per 100 oz)too_few_foods when fewer than 2 resolveusda_list_nutrients toolcategory filter: macronutrients, vitamins, minerals, lipids, amino_acids, othernutrients[] elsewhereusda://food/{fdcId} resourceusda_get_food without portion scaling — full nutrient profile per 100g as application/jsonfdcId must be a bare positive integer (no sign, leading zero, decimal, or exponent); anything else throws invalid_idnot_found when the ID doesn't exist in FDCusda://nutrients resourceusda_list_nutrients with no category filterapplication/json with a 1-hour public cache hint, since the table is bundled at build time and identical for every callerskill://usda-guide/SKILL.md resourceGuidance for matching food records, choosing a serving weight, and reporting incomplete nutrient coverage. The same usda-guide ships with plugin installs, npm, Docker, and the desktop bundle.
Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
FoodData Central-specific:
api.nal.usda.gov/fdc/v1)/foods) with per-food partial failure reportingAgent-friendly output:
dataType) on every food result so callers know whether they're reading curated research data or label-derived branded valuesusda_get_foods, usda_compare_foods) return successes alongside structured failed[] / missingData[] entries rather than failing the whole requestConnect to the hosted instance, no install:
claude mcp add --transport http usda-mcp-server https://usda.caseyjhand.com/mcp
Or run it locally:
claude mcp add usda-mcp-server -e USDA_FDC_API_KEY=your-key -- npx -y @cyanheads/usda-mcp-server
For other clients, add this to the MCP config file:
{
"mcpServers": {
"usda-mcp-server": {
"command": "npx",
"args": ["-y", "@cyanheads/usda-mcp-server"],
"env": { "USDA_FDC_API_KEY": "your-api-key" }
}
}
}
Get a free key at api.data.gov/signup. Food search, lookup, and comparison require it; the static nutrient reference works without it. For Docker or a source build, see Running the server.
See .env.example for the full list of optional overrides.
Requires Bun v1.4.0 or higher (or Node.js v24+).
git clone https://github.com/cyanheads/usda-mcp-server.git
cd usda-mcp-server && bun install
cp .env.example .env # set USDA_FDC_API_KEY
Build and run:
# One-time build
bun run rebuild
# Run the built server
bun run start:stdio
# or
bun run start:http
Run checks and tests:
bun run devcheck # Lint, format, typecheck, security
bun run test # Vitest test suite
bun run lint:mcp # Validate MCP definitions against spec
docker run --rm -e USDA_FDC_API_KEY=your-key -p 3010:3010 ghcr.io/cyanheads/usda-mcp-server:latest
The image defaults to HTTP transport, stateless session mode, and logs to /var/log/usda-mcp-server. For stdio, use docker run -i --rm -e MCP_TRANSPORT_TYPE=stdio -e USDA_FDC_API_KEY=your-key ghcr.io/cyanheads/usda-mcp-server:latest. To build locally, run docker build -t usda-mcp-server .; OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
See CLAUDE.md for development guidelines and architectural rules. The short version:
try/catch in tool logicctx.log for request-scoped logging, ctx.state for tenant-scoped storagesrc/mcp-server/*/definitions/index.tsIssues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run test
Apache-2.0 — see LICENSE for details.
Search foods, compare nutrients, and look up the full USDA FoodData Central database.
{ "mcpServers": { "io.github.cyanheads-usda-mcp-server": { "url": "https://usda.caseyjhand.com/mcp", "headers": {} } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก http สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: USDA_FDC_API_KEY, USDA_CLAMP_LIMITS, MCP_LOG_LEVEL, MCP_TRANSPORT_TYPE, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE
Usda เข้าถึงได้ผ่าน HTTP
ตรวจสอบล่าสุดเมื่อ 2026-11-16 Search foods, compare nutrients, and look up the full USDA FoodData Central database.