使用说明
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支持
贡献
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服务器。