Unit Expert MCP

A small Model Context Protocol server that converts common units for length, weight, temperature, area, and volume.

Tools

• convert_length(value, from_unit, to_unit)

• convert_weight(value, from_unit, to_unit)

• convert_temperature(value, from_unit, to_unit)

• convert_area(value, from_unit, to_unit)

• convert_volume(value, from_unit, to_unit)

• list_supported_units()

Supported Units

Length:

• mm, cm, m, km, in, ft, yd, mi

Weight:

• mg, g, kg, t, oz, lb

Temperature:

• c, f, k

Area:

• mm2, cm2, m2, km2, in2, ft2, yd2, acre

Volume:

• ml, l, m3, in3, ft3, cup, pt, qt, gal, floz

Run Locally

Install dependencies:

uv sync

Run the server directly:

uv run unit-expert-mcp

Run the server with Streamable HTTP:

uv run unit-expert-mcp --transport streamable-http --host 0.0.0.0 --port 8000

Or run with the MCP CLI:

uv run mcp run src/unit_expert_mcp/server.py

Test with MCP Inspector:

uv run mcp dev src/unit_expert_mcp/server.py

Docker

Build and run the server:

docker build -t unit-expert-mcp .
docker run --rm -p 8000:8000 unit-expert-mcp

The Streamable HTTP endpoint is:

http://localhost:8000/mcp

Client Config Example

For clients that launch servers over stdio, use:

{
  "mcpServers": {
    "unit-expert": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/unit-expert-mcp",
        "run",
        "unit-expert-mcp"
      ]
    }
  }
}

Development

uv run pytest
uv run ruff check .