Hostbare Schnittstellen für die ucon Dimensionsanalyse-Engine.
Dokumentation · MCP-Server-Handbuch · Tool-Referenz
ucon ist eine einheitenbewusste Berechnungsbibliothek für Python. ucon-tools verpackt sie in Schnittstellen, die von anderen Systemen genutzt werden können — MCP-Server für KI-Agenten, REST-APIs für Webdienste, CLIs für Menschen am Terminal.
Jede Schnittstelle befindet sich unter ucon.tools.<interface> und ist als optionales Extra installierbar:
Schnittstelle | Paket | Extra | Status |
MCP-Server |
|
| Verfügbar |
REST-API |
|
| Geplant |
CLI |
|
| Geplant |
Related MCP server: Touchstone MCP Server
Der MCP-Server bietet KI-Agenten (Claude, Cursor und anderen MCP-Clients) dimensionsgeprüfte Einheitenumrechnung und Berechnung.
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]Erfordert Python 3.10+.
Claude Desktop / Claude Code — zur MCP-Konfiguration hinzufügen:
{
"mcpServers": {
"ucon": {
"command": "uvx",
"args": ["--from", "ucon-tools[mcp]", "ucon-mcp"]
}
}
}Standalone:
ucon-mcp # stdio transport (default)
ucon-mcp --transport sse # SSE transport for remote clientsKern — Umrechnung und Berechnung:
Tool | Beschreibung |
| Konvertiert einen Wert zwischen kompatiblen Einheiten |
| Mehrstufige Faktor-Label-Berechnung mit Dimensionsverfolgung |
| Erstellt eine Faktorenkette aus natürlichsprachlicher oder strukturierter Eingabe |
| Überprüft, ob zwei Einheiten dieselbe Dimension haben |
Entdeckung — Erkundung des Einheitensystems:
Tool | Beschreibung |
| Listet verfügbare Einheiten auf, optional gefiltert nach Dimension |
| Listet SI-Dezimal- und Binärpräfixe auf |
| Listet verfügbare physikalische Dimensionen auf |
| Listet physikalische Konstanten auf (CODATA 2022) |
| Listet registrierte Fachformeln auf |
Laufzeiterweiterung — Einheiten und Umrechnungen pro Sitzung hinzufügen:
Tool | Beschreibung |
| Registriert eine benutzerdefinierte Einheit für die Sitzung |
| Fügt eine Umrechnungskante hinzu (linear oder affin) |
| Definiert eine benutzerdefinierte physikalische Konstante |
| Ruft eine registrierte dimensions-typisierte Formel auf |
| Löscht alle sitzungsdefinierten Einheiten, Umrechnungen und Konstanten |
Art der Größe (KOQ) — semantische Disambiguierung:
Tool | Beschreibung |
| Registriert eine Größenart zur Disambiguierung |
| Deklariert die erwartete Größenart vor der Berechnung |
| Überprüft, ob ein Ergebnis der deklarierten Art entspricht |
| Listet registrierte Größenarten auf |
| Erstellt eine erweiterte Dimensionsbasis |
| Listet sitzungsdefinierte erweiterte Basen auf |
ucon-tools ist eine Schnittstellenschicht. Es implementiert die Dimensionsanalyse nicht neu — es delegiert an ucon für die gesamte Einheitenauflösung, Umrechnung und Dimensionsalgebra. Was es hinzufügt, ist schnittstellenspezifische Logik: Sitzungsstatus, Protokollbehandlung, Fehlervorschläge und agentenorientierte Funktionen wie den decompose-Constraint-Solver und die KOQ-Disambiguierung.
┌───────────────────────────────────────────────────────┐
│ 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 ist ein metrologischer Reasoning-Benchmark mit 500 Problemen zur Bewertung, wie gut KI-Modelle mit Einheitenumrechnung, Dimensionsanalyse und der Unterscheidung von Größenarten umgehen. Er wird mit einem Runner geliefert, der jedes Modell mit oder ohne MCP-Tool-Erweiterung bewerten kann.
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>/mcpSiehe benchmarks/unitsafe/ für den vollständigen Datensatz, den Runner und das Bewertungsprotokoll.
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. Siehe 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.
