物流AI代理标准

ATLAS是一个开源MCP服务器,为AI代理提供物流运营的深度上下文,数据始终保留在用户的基础设施内。

  • by cargofy
  • JavaScript
  • 本地部署
  • 20 星标
  • 更新于
在 GitHub 查看 cargofy/ATLAS

使用说明

ATLAS-AI运输物流代理标准

开源MCP服务器为AI代理提供有关您的物流运营的深入背景,而您的数据永远不会离开您的基础设施。


问题

企业物流公司拥有多年的运营数据——电子邮件、合同、TMS记录、承运商关系、定价历史。AI代理需要这种上下文才能发挥作用。但是,对于合规、法律和安全团队来说,与外部云服务共享原始数据是不可能的。

结果:人工智能保持浅层。代理人不能根据上下文进行谈判。每一次互动都从零开始。

解决方案

ATLAS运行 在你的安全范围内。它连接到您现有的系统,在本地索引您的数据,并公开标准化的MCP接口。任何人工智能代理都可以查询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功能的生产使用,请参阅 医生.md.

选项2:克劳德桌面

添加到您的 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

网页用户界面

ATLAS附带完整的网络界面,网址为 http://localhost:3000:

第页 描述
仪表盘 服务器状态、记录计数、连接器健康状况、SLA违规
探索者 浏览数据模型,使用可视化过滤器执行查询
聊天 对话式人工智能界面,可调用工具进行物流查询
操场 直接从浏览器测试MCP工具
知识库 管理企业知识文件(markdown、文件夹、CRUD)
导入 上传数据文件(JSON、CSV、XLSX)、种子数据库、从文件夹导入
连接器 查看和管理数据源配置,触发手动同步
模块 启用/禁用插件、触发同步、查看模块状态
设置 Visual+YAML配置编辑器,支持实时重新加载
安装向导 首次运行配置(AI提供者、安全性、实例名称)

MCP工具

ATLAS曝光 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 克劳德·十四行诗/歌剧/俳句 聊天、提取、知识丰富
开放人工智能 GPT-4o,GPT-4o-mini 聊天,提取
奥拉玛 任何本地模型 完全离线操作

人工智能能力:

  • 实体抽取 --上传任何物流文件(PDF、CSV、XLSX、电子邮件)并提取结构化数据(装运、承运商、费率、文件)
  • 知识丰富 --人工智能会根据提取的数据自动更新你的知识库,检测矛盾并添加新的事实
  • 使用工具聊天 --使用MCP工具查询数据的对话界面
  • 角色路由 --为不同的任务(聊天、提取、知识)分配不同的模型

数据模型

核心模型(始终启用)

型号 描述
货运 海运、空运、公路、铁路、多式联运——状态、方式、路线、承运人、计划交付
承运人 配置文件、类型(卡车运输、航运公司、航空公司、铁路、经纪人)、国家、评级
车道 产地→ 目的地与模式和平均运输天数配对
费率 按承运人、航线、模式、日期范围划分的运费定价
文件 BOL、CMR、AWB、发票、海关、POD、装箱单、原产地证书
跟踪事件 提货、运输、交付、异常事件,包括位置和地理位置
服务水平 每条车道/模式/服务类型的计划通行时间

扩展模型(通过配置选择加入)

资产、司机、运输订单、设施、标书、投标报价、中标、派遣、航段、海关报单


连接器

连接器 状态 描述
REST API 可用 具有JSONPath映射、承载/basic/API_key auth的通用REST
文件系统 可用 本地JSON、CSV、TXT、MD文件(可选PDF/DOCX/XLSX)
AI提取 可用 上传文件以提取AI驱动的实体
电子邮件(IMAP/Exchange) v0.2 对物流相关电子邮件进行索引
SAP TM 即将推出 SAP运输管理
Oracle TMS 即将推出 Oracle运输管理
Transpreon 即将推出 Transpreon平台集成
project44 即将推出 可见性和跟踪数据

模块(插件)

模块 说明
文件监视 监控本地文件夹中的新文件,通过AI提取管道自动处理
知识丰富者 从AI提取中自动丰富知识库
谷歌驱动器 将Google Drive文件夹中的文件与AI分析同步(文档/表格导出、递归)

通过以下方式启用/禁用模块 config.yml 或Web UI中的模块页面。


建筑

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进行完全离线操作
  • 承载令牌身份验证 --每个令牌的范围权限(读/写)
  • 非root Docker --以无特权方式运行 atlas 用户
  • 审计日志 --对实例进行的每个查询的完整日志
  • 开源 --检查每一行代码

用例

承运人谈判代理

代理商询问ATLAS:“我们在德国与DHL的交易量是多少→第四季度损益?" → 从您自己的数据中获取答案→ 从知识的角度进行谈判。

客户服务代理

“12345号货物在哪里?”→ 代理商从您的TMS向ATLAS查询装运状态→ 无需手动查找即可立即回答。

采购代理

“运往乌克兰的冷藏运输前三大承运商是谁?”→ 代理从ATLAS中提取您的历史性能数据→ 提供数据驱动的推荐。


由Cargofy提供技术支持

ATLAS由以下公司建造和维护 货物 --物流人工智能平台。我们构建ATLAS是因为我们的企业客户需要它。我们开源它是因为物流行业需要一个标准。

Cargofy平台 连接到ATLAS实例以提供:

  • 代表您拨打电话、发送消息、进行谈判的人工智能代理
  • 分析和报告您的ATLAS数据
  • 托管ATLAS主机(如果您不想自主机)
  • 企业连接器和SLA支持

了解更多关于Cargofy的信息


贡献

ATLAS是Apache 2.0授权的。欢迎捐款。

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

看 贡献.md 作为指导方针。


许可证

Apache许可证2.0——请参阅 许可证


列在

ATLAS提交到以下MCP目录和列表:

提交、发现和探索生态系统中的MCP服务器。