Vepathos

Vepathos MCP

AI エージェント向けの大規模な配送とフリートの最適化。

Vepathos はラストマイルのフリート向けに車両経路問題（VRP）を解決します。数十件から数千件の配送先を対象に、1 つのデポから各配送先を車両に割り当て、それぞれのルートの順序を決定します。

このリポジトリはリモート MCP アダプター（mcp.vepathos.com）です。単独の製品ではありません。Web、REST、MCP は同じ Vepathos アカウント、プラン、機能、制限、月間配送先数の上限を共有します。

ツール	機能	データを変更	利用可能
get_account	この接続で使用する Vepathos アカウントと、そのプランで利用できる機能を表示します。	いいえ	常時
optimize_routes	配送ルートを計画します（車両経路問題、VRP）。	はい	常時
list_plans	接続中の Vepathos アカウントのプラン一覧を表示します（ダッシュボードのプランです。最適化はすべていずれかのプランに保存されます）。	いいえ	常時
get_optimization_result	optimization_id で指定したルート最適化のステータスと結果を取得します。	いいえ	常時
import_deliveries	配送データを Vepathos にインポートし、行データがこのチャットを経由しないようにします。	はい	MCP_IMPORT_TOOLS_ENABLED
get_import_result	import_deliveries ジョブのステータスと概要を取得します。	いいえ	MCP_IMPORT_TOOLS_ENABLED
update_import_mapping	再アップロードせずに、インポートの列マッピングを修正します。	はい	MCP_IMPORT_TOOLS_ENABLED
list_datasets	このチャットまたは以前のチャットからのインポート一覧を表示します。	いいえ	MCP_IMPORT_TOOLS_ENABLED
geocode_addresses	Vepathos Smart Import を使用して、住所を緯度・経度に変換します。	はい	常時
get_geocode_result	geocode_addresses ジョブのステータスと座標を取得します。	いいえ	常時
list_fleet	接続中の Vepathos アカウントに保存されている情報を一覧表示します。	いいえ	常時
manage_catalog	アカウントに保存される車両、デポ、またはフリートを追加・変更します。これらのマスターデータは、この会話の後も保持されます。	はい	MCP_CATALOG_WRITE_TOOLS_ENABLED
list_automations	接続中の Vepathos アカウントに設定されているルールを一覧表示します。	いいえ	常時
create_automation	スケジュールに沿って配送をルーティングするルールを作成します。	はい	常時
create_optimization_map	接続中のアカウントが所有する完了済み最適化の地図への、一時的な公開リンクを作成します。	はい	MCP_MAP_SHARES_ENABLED

自動化を有効にするツールはありません。create_automation は常にオフの状態でルールを登録します。ルールをオンにできるのはその所有者だけで、ダッシュボードから操作します。有効なルールは、所有者が操作していない間も配送先数を消費するためです。

キャンセル用のツールはありません。送信された最適化は完了まで実行されます。住所は、事前に geocode_addresses（またはインポートツールが有効な場合は import_deliveries）を通す必要があります。optimize_routes が座標を生成することはありません。

ステータス

本番環境では https://mcp.vepathos.com/mcp で 0.11.1 が稼働しており、15 個すべてのツールを公開しています。インポートツール、共有可能なマップ、manage_catalog はすべて有効になっているため、上記の「利用可能」列はコードで制御される内容を示しており、このデプロイ環境で提供されない機能を示しているわけではありません。

manage_catalog では、車両、デポ、そしてそのアカウントがすでに持っている車両をまとめたフリートの 3 種類を保存できます。フリートの units は、保有している車両数であり、1 回の運行で出発する車両数ではありません。1 回の運行で出発する車両数は、optimize_routes の vehicles[].count です。保存したフリートを使うには、list_fleet で読み込み、その車両を渡してください。optimize_routes は fleet_id を受け取りません。

Vepathos は、公式 MCP レジストリでは com.vepathos/vepathos として、Smithery および Glama に掲載されています。ディレクトリはクロール時点の情報を掲載するため、掲載内容がデプロイから 1 日ほど遅れる場合があります。レジストリのエントリはバージョン更新のたびに再公開されます。

有料プランへのセルフサービス申し込みは無効になっています。アカウントのプランでは実行できないリクエストには、Stripe Checkout のリンクではなく、contact_url を含む PLAN_UPGRADE_REQUIRED が返されます。アカウントで実行可能になった後は、再接続せずに再試行できます。

本番環境以外で実行する方法は 2 つあります。

• ローカルおよび CI：実際のルーティングやジオコーディングを行わないテスト用代替実装である fake Core に接続するサーバーです。tests/ 内のすべてのテストでこれを使用します。
• ローカルから実際のスタックに接続：vepathos-api-doc MCP チャネル、オプティマイザー、Smart Import ワーカーを使用します。

接続（本番環境の接続先）

Add Vepathos → Connect → Sign in / Sign up → Authorize

1. Claude または他の MCP クライアントから Vepathos を見つけます。
2. 接続します。クライアントは api.vepathos.com でサインインするか、Free / Duck アカウントを作成します。
3. そのアカウントでルートを最適化することをクライアントに許可します。
4. optimize_routes を呼び出します。プランでリクエストを実行できない場合、ツールは upgrade_url（有料プランが有効な場合）または contact_url（Stripe の設定が完了するまでの Free のみの場合）を含む PLAN_UPGRADE_REQUIRED を返します。有効な場合、支払いはすべて Stripe が処理します。アカウントでジョブを実行できるようになった後は、再接続せずに再試行してください。

このフローでは API キーも JSON 設定も不要です。docs/onboarding.md をご覧ください。

開発者とヘッドレスエージェント

スコープ mcp:optimize を設定した Vepathos ダッシュボード認証情報を作成し、次を送信します。

Authorization: Bearer <client_id>:<client_secret>

送信先は https://mcp.vepathos.com/mcp です。使用量は Web アプリや REST API と同じアカウントプランに計上されます。

例（3,200 件の配送）

{
  "depot": { "latitude": 40.7128, "longitude": -74.0060 },
  "vehicles": [
    { "vehicle_id": "van", "count": 35, "max_weight_kg": 900, "max_volume_m3": 8.0 }
  ],
  "stops": [
    {
      "stop_id": "ORD-10045",
      "latitude": 40.7306,
      "longitude": -73.9352,
      "weight_kg": 18.5,
      "volume_m3": 0.04,
      "time_window": { "start": "09:00", "end": "12:00" }
    }
  ],
  "schedule": {
    "date": "2026-10-01",
    "route_start_time": "07:30",
    "time_zone": "America/New_York",
    "service_time_minutes": 4
  }
}

各停車地点には緯度と経度が必要です。住所はジオコーディングされません。重量、容積、時間枠は任意です。いずれかの車両に積載量を設定する場合は、すべての車両と停車地点にその項目を含める必要があります。時間枠には schedule.route_start_time が必要です。

結果は 24 時間利用できます。detail=summary は簡潔な結果（合計とルート一覧の 1 ページ）を返します。detail=stops は、座標を再掲せず、順序付けられた stop_id と到着時刻を返します。

完全なスキーマとエラーについては、docs/tools.md をご覧ください。

ローカルで実行する

Python 3.12 以降が必要です。

python3.12 -m venv .venv && .venv/bin/pip install -e ".[dev]"
cp .env.example .env
docker compose up --build

MCP エンドポイントは http://127.0.0.1:8080/mcp で、Authorization: Bearer dev-bearer-token-change-me を指定します。この compose スタックはオプティマイザーではなく fake Core と通信します。

.venv/bin/pytest -m "not integration"
.venv/bin/mypy
.venv/bin/ruff check src tests devtools

MCP Inspector と、実際のローカルスタックに対する統合テストについては、 docs/testing.md をご覧ください。

プライバシー

ツールが受け取るのは、座標、任意の重量・容積・時間枠、およびユーザー独自の停車地点 ID と車両 ID です。住所は geocode_addresses と import_deliveries を通じて Smart Import に送信され、応答には含まれません。結果に座標は含まれず、ログにはトークン、ペイロード、座標を記録しません。ホスト環境の結果は 24 時間保持されます。

アカウントデータと物流データは、MCP に関するセクションを含む公開ポリシー vepathos.com/privacy に従って取り扱われます。docs/security.md と SECURITY.md もご覧ください。

調査とベンチマーク

Vepathos のラストマイル最適化については、公開技術レポートで説明しています： doi:10.5281/zenodo.19859531。この登録文書は査読済みの出版物ではありません。

ドキュメント

ドキュメント	トピック
docs/architecture.md	ADR：スタンドアロンアダプター、信頼モデル、認証、トライアル
docs/core-changes.md	必須となる Core（vepathos-api-doc）の変更
docs/core-channel-contract.md	HTTP コントラクト /api/mcp/v1
docs/auth.md	OAuth、API キー、サービスモード
docs/onboarding.md	接続、登録、アップグレード
docs/tools.md	ツールの動作：計画、確認、マスターデータ、エラー
docs/tools-reference.md	自動生成リファレンス：すべてのツール、入力、アノテーション、ワークフロー
docs/agent-test-plan.md	ヘルスチェックから接続済みストアまで、実際のエージェントで実行するすべてのシナリオと、未解決の調査結果
docs/chatgpt-test-battery.md	ChatGPT だけが確認できること：512 文字のウィンドウ、添付ファイル、キャッシュされたスキーマ
docs/async.md	optimization_id とポーリング。Tasks は後日対応
docs/deployment.md	運用者向けインデックス（コンテナ、Caddy、ヘルスチェック）
docs/deploy-api-prod.md	api-prod での最初の本番リリース（2026-09-14）：すべての手順と落とし穴
docs/publish-marketplaces.md	Claude、MCP Registry、ChatGPT、Cursor — 公開の順序とブロッカー
docs/directory-listing.md	すぐに貼り付けられる掲載文（無料＋お問い合わせ）
docs/publication-checklist.md	レジストリとディレクトリの公開条件
docs/privacy-mcp.md	公開プライバシーポリシーの MCP セクション
docs/public-mcp-page.md	vepathos.com/mcp に掲載する文章

ライセンス

Apache License 2.0