ucon 次元解析エンジン用のホスト可能なインターフェース。
ドキュメント · MCPサーバーガイド · ツールリファレンス
ucon は、Python向けの単位認識計算ライブラリです。ucon-tools は、AIエージェント用のMCPサーバー、Webサービス用のREST API、ターミナル上の人間用のCLIなど、他のシステムが利用できるインターフェースにパッケージ化します。
各インターフェースは ucon.tools.<interface> 配下にあり、オプションの追加機能としてインストール可能です：
インターフェース | パッケージ | 追加機能 | ステータス |
MCPサーバー |
|
| 利用可能 |
REST API |
|
| 計画中 |
CLI |
|
| 計画中 |
Related MCP server: Touchstone MCP Server
MCPサーバーは、AIエージェント（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コア — 変換と計算：
ツール | 説明 |
| 互換性のある単位間で値を変換する |
| 次元追跡を伴う多段階の因子ラベル計算 |
| 自然言語または構造化入力から因子チェーンを構築する |
| 2つの単位が同じ次元を共有しているか確認する |
探索 — 単位システムを探索：
ツール | 説明 |
| 利用可能な単位を一覧表示（次元によるフィルタリング可） |
| SI接頭辞（10進および2進）を一覧表示 |
| 利用可能な物理次元を一覧表示 |
| 物理定数を一覧表示（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 は、AIモデルが単位変換、次元解析、量種別の識別をどの程度うまく処理できるかを評価するための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 を参照してください。
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.
