MCP Units

Provides conversion between cooking measurement units (volume, weight, temperature) via an MCP server for integration with MCP clients and editors.

python

1

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sellisd-mcp-units": {
      "command": "uvx",
      "args": [
        "--with",
        ".",
        "python",
        "-m",
        "mcp_units.server"
      ]
    }
  }
}

You can convert cooking measurements between common units using the MCP Cooking Units Converter server. This MCP enables volume, weight, and temperature conversions to be used by MCP-compatible clients and editors, helping you perform ingredient calculations quickly and accurately.

How to use

To use this MCP server, connect a compatible MCP client to the server and issue a conversion request for the unit type you need. The server supports volume conversions (ml, l, cup, tbsp, tsp), weight conversions (g, kg, oz, lb), and temperature conversions (Celsius and Fahrenheit). You can pass a source value in one unit and receive the equivalent in another unit. Use it to quickly translate recipe quantities, scale ingredients, or verify unit consistency across your workflow.

How to install

Prerequisites: you need Python for the server package and Node tools for optional client installation. You will also use a runtime command to start the MCP server.

Step 1: Install via Smithery (automatic, client-specific)

npx -y @smithery/cli install @sellisd/mcp-units --client claude

Step 2: Manual installation from source

git clone git@github.com:sellisd/mcp-units.git
cd mcp-units
uv pip install .  # For normal use
# OR
uv pip install -e .  # For development

Running the server

Start the MCP server using the runtime command shown here. This launches the server in standard output mode, ready to accept MCP requests from your client applications.

uvx --with . python -m mcp_units.server

Available tools

Volume Conversion

Converts between volume units such as ml, l, cup, tbsp, and tsp to enable accurate ingredient measurements.

Weight Conversion

Converts between weight units such as g, kg, oz, and lb for precise ingredient mass calculations.

Temperature Conversion

Converts between Celsius and Fahrenheit to translate cooking temperatures across scales.