Skip to main content
Glama
Ingredient Convert MCP

Ingredient Convert MCP

README.md
# ingredient-convert-mcp

Cooking ingredient unit converter MCP server. Converts between cups, tablespoons, teaspoons,
millilitres, fluid ounces, grams and ounces using a per-ingredient density table
(1 cup all-purpose flour = 125 g, 1 cup water = 236.588 g, 1 cup honey = 340 g), and scales recipes.

Tools: `convert_ingredient`, `list_ingredients`, `scale_recipe`, `convert_bulk`,
`decimal_to_fraction`, `fraction_to_decimal`, `common_conversions`.

## Connect

Hosted endpoint (Streamable HTTP, no token, no sign-up):

```
https://ingredient-convert-mcp.lipmichal.workers.dev/mcp
```

Paste it into any MCP client that accepts a remote server URL (a custom connector, ChatGPT developer mode), or:

```
claude mcp add --transport http ingredient-convert https://ingredient-convert-mcp.lipmichal.workers.dev/mcp
```

Local stdio from this repository:

```
npm ci && npm run build
node dist/stdio.js
```

## Notes

- Deterministic: no network calls, no clock, no randomness. The hosted Worker makes no upstream request.
- Densities are US customary reference values (King Arthur Baking ingredient weight chart, USDA FoodData Central where available). Volume measures assume level, unpacked cups.
- The hosted Worker accepts a well-formed `mcp-protocol-version` newer than its SDK knows (for example `2026-07-28`) and serves it as the SDK's latest version; malformed values are still refused with 400.
- Web calculator: https://ingredientcalculator.com

## License

MIT

TDQS

A3.7/5.0

Scored across 7 tools

Disambiguation4/5

Each tool has a distinct role: two inverse format converters, a static lookup, a density table lister, a single-item converter, a recipe scaler, and a batch converter. The main friction is convert_ingredient vs convert_bulk (bulk is clearly described as the batch variant with per-item error reporting) and common_conversions vs convert_ingredient, which overlap in output but differ by being a curated static lookup.

Naming Consistency4/5

All names use consistent snake_case, and most follow verb_noun (list_ingredients, convert_ingredient, scale_recipe, convert_bulk). Minor deviations: decimal_to_fraction and fraction_to_decimal use an X_to_Y pattern, and common_conversions is a bare noun phrase, but all remain transparent.

Tool Count5/5

Seven tools is well-scoped for a cooking-conversion server; each covers a distinct operation (format conversion, lookup, single, batch, scaling) with no filler.

Completeness4/5

The surface covers the core lifecycle: fraction/decimal conversion both ways, ingredient density listing, single and bulk ingredient conversion, and recipe scaling with friendly output. Minor gaps remain, notably temperature/oven conversions and a way to add or override ingredient densities.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues