Хостируемые интерфейсы для движка размерного анализа ucon.
Документация · Руководство по MCP-серверу · Справочник инструментов
ucon — это библиотека для вычислений с учетом единиц измерения для Python. ucon-tools упаковывает её в интерфейсы, которые могут использовать другие системы — MCP-серверы для ИИ-агентов, REST API для веб-сервисов, CLI для людей в терминале.
Каждый интерфейс находится в ucon.tools.<interface> и устанавливается как дополнительный пакет:
Интерфейс | Пакет | Дополнение | Статус |
MCP-сервер |
|
| Доступно |
REST API |
|
| Запланировано |
CLI |
|
| Запланировано |
Related MCP server: Touchstone MCP Server
MCP-сервер предоставляет ИИ-агентам (Claude, Cursor и другим клиентам MCP) возможность преобразования единиц измерения и вычислений с проверкой размерности.
Agent: "Convert 5 mcg/kg/min for an 80 kg patient to mL/h. Drug is 400 mg in 250 mL."
decompose → constraint solver places quantities, auto-bridges mcg→mg and min→h
compute → 5 × 80 kg × (60 min/h) × (1 mg/1000 mcg) × (250 mL/400 mg) = 15 mL/h
validate → result dimension matches expected unit ✓pip install ucon-tools[mcp]Требуется Python 3.10+.
Claude Desktop / Claude Code — добавьте в свою конфигурацию MCP:
{
"mcpServers": {
"ucon": {
"command": "uvx",
"args": ["--from", "ucon-tools[mcp]", "ucon-mcp"]
}
}
}Автономно:
ucon-mcp # stdio transport (default)
ucon-mcp --transport sse # SSE transport for remote clientsЯдро — преобразование и вычисления:
Инструмент | Описание |
| Преобразование значения между совместимыми единицами |
| Многошаговое вычисление с отслеживанием размерностей |
| Построение цепочки множителей из естественного языка или структурированного ввода |
| Проверка, имеют ли две единицы одинаковую размерность |
Обнаружение — исследование системы единиц:
Инструмент | Описание |
| Список доступных единиц, опционально с фильтрацией по размерности |
| Список десятичных и двоичных приставок СИ |
| Список доступных физических размерностей |
| Список физических констант (CODATA 2022) |
| Список зарегистрированных предметных формул |
Расширение среды выполнения — добавление единиц и преобразований для сессии:
Инструмент | Описание |
| Регистрация пользовательской единицы для сессии |
| Добавление правила преобразования (линейного или аффинного) |
| Определение пользовательской физической константы |
| Вызов зарегистрированной формулы с типизацией размерностей |
| Очистка всех определенных в сессии единиц, преобразований и констант |
Вид величины (KOQ) — семантическая дезамбигуация:
Инструмент | Описание |
| Регистрация вида величины для дезамбигуации |
| Объявление ожидаемого вида величины перед вычислением |
| Проверка соответствия результата объявленному виду |
| Список зарегистрированных видов величин |
| Создание расширенного размерного базиса |
| Список определенных в сессии расширенных базисов |
ucon-tools — это слой интерфейса. Он не перереализует размерный анализ — он делегирует все задачи по разрешению единиц, преобразованию и размерной алгебре библиотеке ucon. Он добавляет логику, специфичную для интерфейса: состояние сессии, обработку протокола, подсказки об ошибках и ориентированные на агентов функции, такие как решатель ограничений decompose и дезамбигуация KOQ.
┌───────────────────────────────────────────────────────┐
│ Clients │
│ MCP (Claude, Cursor) · HTTP · Terminal │
└──────────┬──────────────────┬──────────────┬──────────┘
│ │ │
┌──────────▼───┐ ┌──────────▼───┐ ┌───────▼──────┐
│ ucon.tools │ │ ucon.tools │ │ ucon.tools │
│ .mcp │ │ .rest │ │ .cli │
│ │ │ │ │ │
│ sessions │ │ (planned) │ │ (planned) │
│ decompose │ │ │ │ │
│ KOQ │ │ │ │ │
│ suggestions │ │ │ │ │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ │ │
└──────────────────┼─────────────────┘
│ Python imports
┌──────────▼──────────┐
│ ucon │
│ │
│ Units, Dimensions │
│ ConversionGraph │
│ Scales, Constants │
└─────────────────────┘UnitSafe — это метрологический бенчмарк из 500 задач для оценки того, насколько хорошо ИИ-модели справляются с преобразованием единиц, размерным анализом и различением видов величин. Он поставляется с исполнителем, который может оценить любую модель с использованием инструментов MCP или без них.
pip install ucon-tools[benchmark]
# Bare evaluation (model solves from memory)
python benchmarks/unitsafe/run.py -m claude:claude-haiku-4-5-20251001
# Tool-augmented evaluation (model uses MCP tools)
python benchmarks/unitsafe/run.py -m claude:claude-haiku-4-5-20251001 \
--tools --mcp-url https://mcp.ucon.dev/mcp/<instance>/mcpСм. benchmarks/unitsafe/ для получения полного набора данных, исполнителя и протокола оценки.
make venv # Create virtual environment
source .ucon-tools-3.12/bin/activate # Activate
make test # Run tests
make test-all # Run across all supported Python versionsmake mcp-server # Foreground (stdio)
make mcp-server-bg # Background
make mcp-server-stop # Stop background serverAGPL-3.0. См. LICENSE.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
60+ units, live FX, timezones, and date arithmetic for AI agents.
Exact fraction math for AI agents. No floating-point drift. CODATA 2022 constants and units.
500+ deterministic tools for AI agents: math, conversion, validation, hashing, encoding, date/time.
AI-callable calculators and engineering models with real formulas. No hallucinated math.
