Skip to main content
Glama
deenesjakoruzh
Robbo-lab

Unit Converter MCP Server

by Robbo-lab
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

API конвертера единиц измерения + руководство по MCP

  • собирает приложение FastAPI, оборачивает его с помощью FastMCP, монтирует конечные точки MCP HTTP/SSE, регистрирует ресурсы и подсказки, а также запускает uvicorn.

  • requirements.txt – зависимости Python.

Предварительные требования

  • Python 3.10+ (протестировано на 3.12).

  • Виртуальное окружение.

  • Инспектор npm ниже.

⸻

Related MCP server: Local Utilities MCP Server

Настройка из этой папки

python -m venv .venv

# Mac or Gitbash
source .venv/bin/activate

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

⸻

Запуск HTTP + MCP сервера

# start the server
python converter_streamable_http_server.py

# or
python -m converter_streamable_http_server

Вы увидите:

Конечные точки MCP, обслуживаемые FastMCP:

⸻

Попробуйте HTTP-конечные точки (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"

Каждая конечная точка возвращает JSON вида:

  • { "result": , "operation": "..." } или { "error": "..." } для неверного ввода.

Заголовки и аутентификация (общие для всех)

Добавьте тип контента JSON (и при необходимости ваш токен аутентификации)

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

Наш сервер пока не требует аутентификации, мы можем опустить заголовок Authorization.

Использование с MCP (пример для VS Code)

  1. Запустите сервер, как описано выше.

  2. Укажите вашему MCP-клиенту процесс.

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

  1. В MCP-клиенте выведите список артефактов. Вы должны увидеть:

    • Инструменты: celsius_to_fahrenheit, fahrenheit_to_celsius, kilometers_to_miles, miles_to_kilometers

    • Ресурсы: resource://unit_reference, resource://troubleshooting_guide

    • Подсказки: explain_conversion, api_usage

⸻

Проверка с помощью инспектора npm MCP

  • исследуйте всё (инструменты, ресурсы, подсказки) в браузере.

  • при условии, что сервер уже запущен на 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

Запуск только STDIO-сервера

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

  • Интерфейс по умолчанию работает на localhost:5173.

  • Измените порт интерфейса, если нужно: CLIENT_PORT=8080 npx @modelcontextprotocol/inspector --url http://localhost:8003/mcp --transport http

  • Добавьте заголовки, если требуется: --header "Authorization: Bearer TOKEN".

Примеры JSON-RPC для подсказок и ресурсов

  1. Список всех подсказок

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

⸻

  1. Получить конкретную подсказку

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

⸻

  1. Отрисовать/выполнить подсказку с переменными

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}'

  1. Список доступных ресурсов

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

  1. Чтение ресурса по 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}'

  1. Поиск ресурсов (если поддерживается)

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}'

⸻

Обработка ошибок

  • Ошибка парсинга (-32700)

  • Неверный запрос (-32600)

  • Метод не найден (-32601)

  • Неверные параметры (-32602)

  • Внутренняя ошибка (-32603)

Примечания

macOS/Linux (bash/zsh) • Приведенные выше примеры будут работать как есть.

# 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

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Weather MCP Server

    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.
    19 npm
    -

  • Local Utilities MCP Server

    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.
    MIT

  • mcp-units

    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.
    3
    1
    MIT

  • mcp-units

    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.
    5
    MIT