Atlas – Ai Transport Logistics Agent Standard

ATLAS — AI 輸送ロジスティクスエージェント標準

AI エージェントが物流業務の詳細なコンテキストを把握できるようにするオープンソース MCP サーバーです。データがインフラストラクチャの外に出ることはありません。

---

問題

物流業界のエンタープライズ企業には、メール、契約書、TMS の記録、運送会社との関係、価格履歴など、長年にわたる業務データが蓄積されています。AI エージェントが役立つには、こうしたコンテキストが必要です。しかし、生データを外部のクラウドサービスと共有することは、コンプライアンス、法務、セキュリティの各チームにとって受け入れられません。

その結果、AI の活用は浅いままです。エージェントはコンテキストに基づいて交渉できません。やり取りのたびに、すべてがゼロから始まります。

解決策

ATLAS はセキュリティ境界の内側で稼働します。既存のシステムに接続し、データをローカルでインデックス化して、標準化された MCP インターフェースを公開します。あらゆる AI エージェントが ATLAS に問い合わせ、業務に関する詳細なコンテキストを取得できます。データがインフラストラクチャの外に出ることはありません。

[Your Company]                        [Cargofy / Any AI Agent]
  ├── Email                                      │
  ├── TMS                    MCP Protocol        │
  ├── ERP          ←─────────────────────────────┤
  ├── Contracts              (questions only,    │
  ├── Knowledge Base          no raw data out)   │
  └── ATLAS instance ────────────────────────────┘

データは手元に残ります。エージェントは必要なコンテキストを取得できます。

---

クイックスタート

オプション 1：Docker（推奨）

docker run -p 3000:3000 cargofy/atlas

http://localhost:3000 を開くと、セットアップウィザードで初期設定を進められます。

永続データと AI 機能を使用する本番環境での利用については、DOCKER.md を参照してください。

オプション 2：Claude Desktop

claude_desktop_config.json の mcpServers の下に追加します。

{
  "atlas": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "cargofy/atlas", "node", "src/index.js"]
  }
}

オプション 3：ソースから実行

git clone https://github.com/cargofy/ATLAS
cd ATLAS
npm install
cp config.example.yml config.yml   # edit with your settings
node seed.js                       # optional: load sample data
node src/ui-server.js              # Web UI + API on port 3000
# or
node src/index.js                  # MCP server on stdio

---

Web UI

ATLAS には、http://localhost:3000 で利用できるフル機能の Web インターフェースが付属しています。

ページ	説明
ダッシュボード	サーバーのステータス、レコード数、コネクターの稼働状況、SLA 違反
エクスプローラー	データモデルの閲覧、ビジュアルフィルターを使ったクエリの実行
チャット	物流に関するクエリでツール呼び出しに対応した、対話型 AI インターフェース
プレイグラウンド	ブラウザーから MCP ツールを直接テスト
ナレッジベース	エンタープライズのナレッジファイル（Markdown、フォルダー、CRUD）を管理
インポート	データファイル（JSON、CSV、XLSX）のアップロード、データベースへの初期データ投入、フォルダーからのインポート
コネクター	データソースの設定を表示・管理し、手動同期を開始
モジュール	プラグインの有効化・無効化、同期の開始、モジュールのステータス確認
設定	ビジュアルおよび YAML 設定エディター（ライブリロード対応）
セットアップウィザード	初回起動時の設定（AI プロバイダー、セキュリティ、インスタンス名）

---

MCP ツール

ATLAS はModel Context Protocolを介して 35 個の MCP ツールを公開します。MCP 互換のエージェントであれば接続できます。

カテゴリー	ツール
ディスカバリー	get_available_models、get_schema、get_available_carriers、get_available_lanes、get_available_document_types、get_sync_status
クエリ	get_records、query（すべてのデータを対象とした自然言語検索）
貨物	get_shipment、get_shipments、get_shipment_events、get_unsigned_documents、get_closure_checklist
運送会社	search_carriers、get_carrier_shipments
運賃	get_rate_history
ドキュメント	list_documents
業務	get_sla_violations、get_idle_assets、get_anomalies、get_active_issues（20 種類以上の混乱要因）

---

AI 機能

ATLAS は、役割に基づくモデルルーティングで複数の AI プロバイダーに対応しています。

プロバイダー	モデル	用途
Anthropic	Claude Sonnet/Opus/Haiku	チャット、抽出、ナレッジの拡充
OpenAI	GPT-4o, GPT-4o-mini	チャット、抽出
Ollama	任意のローカルモデル	完全オフラインでの運用

AI の機能:

• エンティティ抽出 — 任意の物流書類（PDF、CSV、XLSX、メール）をアップロードして、構造化データ（出荷、運送業者、料金、書類）を抽出します
• ナレッジの拡充 — AI が抽出データからナレッジベースを自動で更新し、矛盾を検出して新しい事実を追加します
• ツールを使ったチャット — MCP ツールを使ってデータを検索する対話型インターフェースです
• 役割に基づくルーティング — タスク（チャット、抽出、ナレッジ）ごとに異なるモデルを割り当てます

---

データモデル

コアモデル（常に有効）

モデル	説明
Shipments	海上、航空、道路、鉄道、複合輸送 — ステータス、輸送モード、ルート、運送業者、納品予定
Carriers	プロフィール、種別（トラック輸送、海運会社、航空会社、鉄道、ブローカー）、国、評価
Lanes	輸送モードと平均輸送日数を含む出発地 → 目的地の組み合わせ
Rates	運送業者、レーン、輸送モード、期間別の貨物運賃
Documents	BOL、CMR、AWB、請求書、通関書類、POD、梱包明細書、原産地証明書
Tracking Events	集荷、輸送、配達、例外のイベントと場所および地理位置情報
Service Levels	レーン／輸送モード／サービスタイプごとの予定輸送時間

拡張モデル（設定からオプトイン）

資産、ドライバー、輸送注文、施設、入札、入札見積もり、入札落札、配車、区間、通関申告

---

コネクター

コネクター	ステータス	説明
REST API	利用可能	JSONPath マッピング、Bearer／Basic／api_key 認証に対応する汎用 REST
ファイルシステム	利用可能	ローカルの JSON、CSV、TXT、MD ファイル（PDF／DOCX／XLSX は任意）
AI Extract	利用可能	AI によるエンティティ抽出のためのファイルアップロード
Email (IMAP/Exchange)	v0.2	物流関連メールをインデックス化します
SAP TM	提供予定	SAP Transportation Management
Oracle TMS	提供予定	Oracle Transportation Management
Transporeon	提供予定	Transporeon プラットフォームとの連携
project44	提供予定	可視化および追跡データ

モジュール（プラグイン）

モジュール	説明
file-watch	ローカルフォルダー内の新しいファイルを監視し、AI 抽出パイプラインで自動処理します
knowledge-enricher	AI による抽出結果からナレッジベースを自動で拡充します
google-drive	AI 分析（Docs／Sheets のエクスポート、再帰処理）を行いながら、Google Drive フォルダーのファイルを同期します

モジュールは config.yml または Web UI の Modules ページから有効／無効にできます。

---

アーキテクチャ

ATLAS Instance (your infrastructure)
├── AI Layer
│   ├── Multi-provider LLM client (Claude, OpenAI, Ollama)
│   ├── Entity extraction pipeline
│   ├── Knowledge engine (enrichment + contradiction detection)
│   └── Chat with tool calling
├── Module System (plugin architecture)
│   ├── file-watch
│   ├── knowledge-enricher
│   └── google-drive
├── Connectors
│   ├── REST API connector
│   ├── Filesystem connector
│   └── AI extraction connector
├── Storage Layer
│   ├── SQLite (default) or PostgreSQL
│   └── Knowledge base (markdown files)
├── MCP Server
│   ├── stdio transport (CLI / Claude Desktop)
│   └── HTTP/SSE transport (remote agents)
└── Web UI + REST API
    ├── Dashboard, Explorer, Chat, Playground
    ├── Knowledge Base manager
    ├── Settings, Modules, Import
    └── Setup Wizard

---

セキュリティとプライバシー

• データの外部送信ゼロ — ATLAS はネットワーク外に生データを送信しません
• ローカル AI の選択肢 — Ollama を実行して完全オフラインで運用できます
• Bearer トークン認証 — トークンごとに権限（読み取り／書き込み）を設定できます
• 非 root の Docker — 権限のない atlas ユーザーとして実行します
• 監査ログ — インスタンスに対して行われたすべてのクエリの完全なログを記録します
• オープンソース — コードのすべての行を確認できます

---

ユースケース

運送業者との交渉エージェント

エージェントが ATLAS に問い合わせます：「Q4 における DE→PL 間の DHL との取扱量は？」→ 自社データから回答を取得 → 知識に基づいて交渉します。

カスタマーサービスエージェント

「出荷 #12345 はどこにありますか？」→ エージェントが TMS から出荷状況を取得するため ATLAS に問い合わせます → 手動で検索せずに即座に回答します。

調達エージェント

「ウクライナ向けの冷蔵輸送で、上位 3 社の運送業者は？」→ エージェントが ATLAS の過去の実績データを取得します → データに基づく提案を行います。

---

Cargofy によって支えられています

ATLAS は、ロジスティクス向け AI プラットフォームを提供する Cargofy が構築・保守しています。エンタープライズのお客様からのニーズを受けて ATLAS を開発しました。ロジスティクス業界に標準が必要だと考え、オープンソース化しました。

Cargofy プラットフォームを ATLAS インスタンスに接続すると、次の機能を利用できます。

• 通話、メッセージの送信、代理交渉を行う AI エージェント
• ATLAS のデータに基づく分析とレポート
• ATLAS のマネージドホスティング（セルフホストを希望しない場合）
• エンタープライズ向けコネクターと SLA サポート

Cargofy の詳細を見る

---

コントリビューション

ATLAS は Apache 2.0 ライセンスで提供されています。コントリビューションを歓迎します。

git clone https://github.com/cargofy/atlas
cd atlas
npm install
npm run dev

ガイドラインについては、CONTRIBUTING.md をご覧ください。

---

ライセンス

Apache License 2.0 — LICENSE をご覧ください。

---

掲載先

ATLAS は、以下の MCP ディレクトリおよびリストに登録されています。

エコシステム内の MCP サーバーを登録、検索、閲覧できます。