Upri — 1台で動かす発送準備API・画面・MCP

Windows・macOS・Linuxそれぞれの同じPC内にAPI、操作画面、SQLite、 AI用MCPクライアントを導入します。別のUbuntu・Windows PCは不要です。

**できること：**手入力／99列CSV／REST APIで下書き作成、内容プレビュー、 ゆうプリR取込用CSVの出力、作業状況の手動記録。 **未検証：**日本郵便の会員認証後の正式ラベル発行・実印刷。 CSV作成は印刷完了ではありません。日本郵便の公式サービスではありません。

まずローカルで起動

uv公式手順でuvを導入し、 このリポジトリを取得します。Pythonはuvが同じPCに用意します。

git clone https://github.com/RyosukeMondo/u-pri.git
cd u-pri
uv sync --frozen --python 3.12
uv run python scripts/local.py setup
uv run python scripts/local.py serve

ブラウザーで http://127.0.0.1:18767/demo を開くと、キー不要で架空データを試せます。 実際の下書きは http://127.0.0.1:18767/ を使います。 APIキーのファイルはsetupが場所だけ表示します。キーをチャットに貼らないでください。 端末を閉じるとサーバーは停止します。同じserveコマンドで再開できます。

別のローカルTerminalで確認：

uv run python scripts/local.py doctor

Related MCP server: Japan Logistics MCP

同じPCでゆうプリR本体も使う

Mac/Linux試験版（GUIセッションのTerminalで実行）：

uv run python setup/desktop.py install --accept-experimental
uv run python setup/desktop.py registration

Wine・Rosettaなどの条件、取得元、再実行・削除方法は OS別セットアップ を読んでください。 MacではWineを配布元から自動取得します。LinuxではローカルにWine・7z・msiextractの導入が必要です。 Microsoft・日本郵便のソフトは公式配布元から直接取得し、ここには同梱しません。 自作互換部品のみGitHub ReleaseからSHA-256照合して取得します。

Claudeに導入を依頼

コピーして使えるプロンプト — Claude Code／Claude Desktop作業モード向け。 Claude Desktopのクラウド・隔離VM内への導入を、Mac本体への導入と誤認しないようにしてください。

setupが同じPCの127.0.0.1に接続するMCP設定を生成します。 APIキーを含まないmcp/claude-config.snippet.jsonを既存のMCP設定にマージし、 ホストを再起動します。4つのツールは下書き準備・取得用で、print_labelはありません。 APIと操作画面 ／ 検証結果

開発・公開範囲

uv run pytest
uv run python scripts/smoke.py

デモPDFは発送不可です。公開リポジトリに顧客データ、認証情報、公式インストーラー、 同梱RPX帳票、私用の試験環境を含めません。558件の帳票ギャラリーも同梱しません。 自作コードはMIT、参照スキーマはCC BY 4.0、同梱IPAゴシックはIPAフォントライセンスv1.0です。