Interfaces alojables para el motor de análisis dimensional ucon.
Documentación · Guía del servidor MCP · Referencia de herramientas
ucon es una biblioteca de computación consciente de las unidades para Python. ucon-tools la empaqueta en interfaces que otros sistemas pueden consumir: servidores MCP para agentes de IA, API REST para servicios web, CLI para humanos en una terminal.
Cada interfaz reside en ucon.tools.<interface> y se puede instalar como un extra opcional:
Interfaz | Paquete | Extra | Estado |
Servidor MCP |
|
| Disponible |
API REST |
|
| Planificado |
CLI |
|
| Planificado |
Related MCP server: Touchstone MCP Server
El servidor MCP proporciona a los agentes de IA (Claude, Cursor y otros clientes MCP) conversión de unidades y computación verificadas dimensionalmente.
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]Requiere Python 3.10+.
Claude Desktop / Claude Code — añadir a su configuración de MCP:
{
"mcpServers": {
"ucon": {
"command": "uvx",
"args": ["--from", "ucon-tools[mcp]", "ucon-mcp"]
}
}
}Independiente:
ucon-mcp # stdio transport (default)
ucon-mcp --transport sse # SSE transport for remote clientsNúcleo — conversión y computación:
Herramienta | Descripción |
| Convertir un valor entre unidades compatibles |
| Cálculo de factor-etiqueta de varios pasos con seguimiento dimensional |
| Construir una cadena de factores a partir de lenguaje natural o entrada estructurada |
| Comprobar si dos unidades comparten la misma dimensión |
Descubrimiento — explorar el sistema de unidades:
Herramienta | Descripción |
| Listar unidades disponibles, opcionalmente filtradas por dimensión |
| Listar prefijos decimales y binarios del SI |
| Listar dimensiones físicas disponibles |
| Listar constantes físicas (CODATA 2022) |
| Listar fórmulas de dominio registradas |
Extensión en tiempo de ejecución — añadir unidades y conversiones por sesión:
Herramienta | Descripción |
| Registrar una unidad personalizada para la sesión |
| Añadir un borde de conversión (lineal o afín) |
| Definir una constante física personalizada |
| Llamar a una fórmula registrada con tipo dimensional |
| Borrar todas las unidades, conversiones y constantes definidas en la sesión |
Tipo de Cantidad (KOQ) — desambiguación semántica:
Herramienta | Descripción |
| Registrar un tipo de cantidad para desambiguación |
| Declarar el tipo de cantidad esperado antes de calcular |
| Validar que un resultado coincida con el tipo declarado |
| Listar tipos de cantidad registrados |
| Crear una base dimensional extendida |
| Listar bases extendidas definidas en la sesión |
ucon-tools es una capa de interfaz. No reimplementa el análisis dimensional; delega en ucon para toda la resolución de unidades, conversión y álgebra dimensional. Lo que añade es lógica específica de la interfaz: estado de la sesión, manejo de protocolos, sugerencias de error y características orientadas al agente como el solucionador de restricciones decompose y la desambiguación 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 es un benchmark de razonamiento metrológico de 500 problemas para evaluar qué tan bien manejan los modelos de IA la conversión de unidades, el análisis dimensional y la discriminación de tipos de cantidad. Se envía con un ejecutor que puede evaluar cualquier modelo con o sin aumento de herramientas 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>/mcpConsulte benchmarks/unitsafe/ para obtener el conjunto de datos completo, el ejecutor y el protocolo de evaluación.
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. Consulte LICENSE.
This server cannot be deployed
60+ units, live FX, timezones, and date arithmetic for AI agents.
Precision math engine for AI agents. 203 exact methods. Zero hallucination.
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.
