How do I use Unit Converter MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Unit Converter MCP Server convert 25 celsius to fahrenheit" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Unit Converter MCP Server

by Robbo-lab

Overview Schema Source Related Servers Discussions Admin

Python

Local

Unit Converter API + MCP Tutorial

builds the FastAPI app, wraps it with FastMCP, mounts MCP HTTP/SSE endpoints, registers resources and prompts, and starts uvicorn.
requirements.txt – Python dependencies.

Prerequisites

Python 3.10+ (tested with 3.12).
Virtual environment.
npm inspector below.

⸻

Related MCP server: Local Utilities MCP Server

Setup from this folder

python -m venv .venv

# Mac or Gitbash
source .venv/bin/activate

# Windows powershell:
.venv\Scripts\activate
python -m pip install -r requirements.txt

⸻

Run the HTTP + MCP server

# start the server
python converter_streamable_http_server.py

# or
python -m converter_streamable_http_server

You’ll see:

Swagger UI: http://localhost:8003/docs
ReDoc: http://localhost:8003/redoc

MCP endpoints served by FastMCP:

streamable-http: http://localhost:8003/mcp
SSE: http://localhost:8003/sse

⸻

Try the HTTP endpoints (curl)

curl -X POST "http://localhost:8003/miles-to-kilometers?miles=3.1" \
 -H "Authorization: Bearer 143f4a46d74fee0d7918b2857577868cb3daf9e6e50ee91c2f7975ba26fdb8f7"

# If we use pydantic models
curl -X POST "http://localhost:8003/miles-to-kilometers" \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer Y658139cf61948208ed76a4b36122b9552ec5c3f6da5e02f7c5d85d995dede17dE" \
 -d "3.1"

# Celsius → Fahrenheit
curl -X POST "http://localhost:8003/celsius-to-fahrenheit" \
 -H "Content-Type: application/json" \
 -d "25"

# Fahrenheit → Celsius
curl -X POST "http://localhost:8003/fahrenheit-to-celsius" \
 -H "Content-Type: application/json" \
 -d "86"

# Kilometers → Miles
curl -X POST "http://localhost:8003/kilometers-to-miles" \
 -H "Content-Type: application/json" \
 -d "5"

# Miles → Kilometers (rejects negative values)
curl -X POST "http://localhost:8003/miles-to-kilometers" \
 -H "Content-Type: application/json" \
 -d "3.1"

Each endpoint returns JSON like:

{ "result": , "operation": "..." } or { "error": "..." } for invalid input.

Headers & Authentication (common to all)

Add JSON content type (and optionally your auth token)

-H "Content-Type: application/json"
-H "Authorization: Bearer "

Our server doesn’t require auth yet, we can omit the Authorization header.

Use with MCP (VS Code Example)

Start the server as above.
Point your MCP client to the process.

// Example VS Code .vscode/mcp.json entry:
{
  "servers": {
    "UnitConverter": {
      "command": "python",
      "args": ["converter_api_tutorial.py"]
    }
  }
}

From the MCP client, list artifacts. You should see:
- Tools: celsius_to_fahrenheit, fahrenheit_to_celsius, kilometers_to_miles, miles_to_kilometers
- Resources: resource://unit_reference, resource://troubleshooting_guide
- Prompts: explain_conversion, api_usage

⸻

Inspect with the npm MCP Inspector

explore everything (tools, resources, prompts) in a browser.
with the server already running on http://localhost:8003

# If env error appears
npx @modelcontextprotocol/inspector@latest -e DUMMY=1 --url http://localhost:8003/mcp --transport streamable-http

# If you want to test the older HTTP:
npx @modelcontextprotocol/inspector@latest -e DUMMY=1 --url http://localhost:8003/mcp --transport http

# If you want to test the deprecated SSE:
npx @modelcontextprotocol/inspector@latest -e DUMMY=1 --url http://localhost:8003/sse --transport sse

To run the STDIO server only

# If venv is ".venv", change to .\.venv\Scripts\python.exe
npx @modelcontextprotocol/inspector python converter_stdio_server.py

UI runs on localhost:5173 by default.
Change UI port if needed: CLIENT_PORT=8080 npx @modelcontextprotocol/inspector --url http://localhost:8003/mcp --transport http
Add headers if required: --header "Authorization: Bearer TOKEN".

JSON-RPC Examples for Prompts & Resources

List all prompts

curl -s -X POST <SERVER_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"prompts/list","params":{},"id":1}'

⸻

Get a specific prompt

curl -s -X POST <SERVER_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"prompts/get","params":{"name":"summarize"},"id":2}'

⸻

Render/execute a prompt with variables

curl -s -X POST <SERVER_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"prompts/render","params":{"name":"summarize","variables":{"text":"This is the content to summarize","tone":"neutral"}},"id":3}'

List available resources

curl -s -X POST <SERVER_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"resources/list","params":{},"id":4}'

Read a resource by URI

curl -s -X POST <SERVER_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"resources/read","params":{"uri":"file:///data/report.pdf"},"id":5}'

Search resources (if supported)

curl -s -X POST <SERVER_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"resources/search","params":{"query":"error OR exception","limit":50},"id":6}'

⸻

Handling errors

Parse error (-32700)
Invalid request (-32600)
Method not found (-32601)
Invalid params (-32602)
Internal error (-32603)

Notes

macOS/Linux (bash/zsh) • The examples above will work as-is.

# Windows PowerShell
curl -Method POST <SERVER_URL> `  -Headers @{ "Content-Type"="application/json" }`
-Body '{"jsonrpc":"2.0","method":"prompts/list","params":{},"id":1}'

Windows CMD

curl -s -X POST <SERVER_URL> -H "Content-Type: application/json" -d "{\"jsonrpc\":\"2.0\",\"method\":\"prompts/list\",\"params\":{},\"id\":1}"

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Openweather A
io.github.pipeworx-io
OpenWeather MCP — wraps the OpenWeatherMap API (openweathermap.org)
Weather Services Location Services
352
BakingTab — Baking Conversions for AI A
io.github.zhaoyaqi18
Baking unit conversion (cups/grams/temp/recipe scaling). convert_amount, convert_temperature
Data Platforms
51
Unit & Currency Converter A
io.github.guptaprakhariitr
60+ units, live FX, timezones, and date arithmetic for AI agents.
Finance Location Services
621
Numbers A
io.github.pipeworx-io
Number utilities MCP.
Developer Tools
352

Related MCP Servers

Weather MCP Server
Weather Services
mkowalskizoovu
F
license
Not graded
quality
D
maintenance
Enables temperature conversion from Fahrenheit to Celsius through HTTP requests. Provides a simple MCP tool for temperature unit conversion with AWS Lambda deployment support.
Updated a year ago (2025-10-21 09:08 UTC)
8 npm
-
Local Utilities MCP Server
Developer Tools File Systems
aiforhumans
A
license
Not graded
quality
D
maintenance
Provides essential utility tools for text processing, file operations, hashing, temperature conversion, password generation, and date/time operations through a comprehensive MCP interface.
Updated a year ago (2025-06-25 19:36 UTC)
MIT
mcp-units
Developer Tools
sellisd
A
license
A
quality
D
maintenance
MCP server for converting cooking measurements (volume, weight, temperature) between common units like ml, cup, g, oz, and Celsius/Fahrenheit.
Updated 3 months ago (2026-06-26 17:43 UTC)
3
1
MIT
mcp-units
Developer Tools
quantumleeps
A
license
A
quality
D
maintenance
An MCP server that provides deterministic unit conversions backed by Pint, enabling exact unit conversions, compatibility checks, and parsing of quantities for LLMs.
Updated 7 months ago (2026-02-18 03:16 UTC)
5
MIT