MCP Samsara

自动化小组-MCP for Samsara

为Claude AI完成Samsara车队管理集成\ 47+工具|内置专家知识|生产就绪

🚀 免费试用版 -锁定您的终身折扣！

______________________________________________________________________

⚠️ 重要免责声明

非正式整合： 这是一个 非官方的 第三方MCP服务器。它是：

• ❌ 非 隶属于Samsara股份有限公司、由其背书或由其赞助。
• ❌ 非 Samsara官方产品
• ✅ 使用Samsara的 公共API 使用您自己的API证书
• ✅ 完全符合Samsara的API服务条款

Samsara® 是Samsara股份有限公司的注册商标。

______________________________________________________________________

🎯 这有什么作用

给克劳德AI 完全访问 到Samsara Fleet Management API：

✅ 47+综合工具 （API全面覆盖，不仅仅是基础）\ ✅ 专家知识 内置于每个工具描述中\ ✅ 自动状态保存 （站点ID、路线数据）\ ✅ 智能限速 （不会达到API限制）\ ✅ 路线优化 （内置效率算法）\ ✅ 生产最佳实践 （错误处理，重试）

包含的工具

车辆管理（4个工具）

• 列出车辆、获取车辆详细信息、实时位置、统计数据

路线管理（7个工具） ⭐ *我们的特色*

• 创建、更新、删除路线
• 自动保持停止状态 （对时间跟踪至关重要！）
• 路线优化 （尽量缩短距离/时间）
• 列出并获取路线详细信息

驾驶员管理（4个工具）

• 列出驱动程序，获取驱动程序详细信息
• 服务时间（HOS）合规性跟踪
• 安全事件监控

地址和位置（2个工具）

• 创建和管理已保存的地址
• 土工格栅集成

Webhook集成（3个工具）

• 实时事件通知
• 路线更新、车辆事件等。

联系人管理（2个工具）

• 创建和管理路线站点的联系人

______________________________________________________________________

🚀 快速开始

先决条件

• Node.js 18+ 安装
• Samsara API代币 (在这里买一个)
• 克劳德桌面版 或任何MCP兼容客户端

安装

# Install via npm
npm install -g @automation-squad/mcp-samsara

# Or clone and build locally
git clone https://github.com/automation-squad/mcp-samsara
cd mcp-samsara
npm install
npm run build

配置

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "samsara": {
      "command": "npx",
      "args": ["-y", "@automation-squad/mcp-samsara"],
      "env": {
        "SAMSARA_API_TOKEN": "your-api-token-here",
        "SAMSARA_BASE_URL": "https://api.samsara.com"
      }
    }
  }
}

欧盟客户： 使用 https://api.eu.samsara.com 对于SAMSARA_BASE_URL

重新启动克劳德

退出并重新打开Claude Desktop。你应该看看可用的Samsara工具！

______________________________________________________________________

💡 示例用法

创建具有优化功能的路线

Create a delivery route called "Morning Zone 1" with these stops:
1. Warehouse: 123 Main St, Springfield
2. Customer A: 456 Oak Ave, Springfield  
3. Customer B: 789 Pine Rd, Springfield
4. Return to warehouse

Then optimize it for minimum distance.

克劳德将：

1. 使用正确的地址创建路由
2. 自动优化止损单
3. 保留所有站点ID以进行跟踪
4. 如有要求，指定车辆/驾驶员

跟踪车辆位置

Show me real-time locations for all vehicles currently on routes

监控驾驶员合规性

Get HOS logs for driver John Smith for the past week and check for any violations

______________________________________________________________________

🔥 是什么让这更好

vs.构建API直接集成

与官方MCP（如果存在）

______________________________________________________________________

🛠️ 建筑

速率限制

保守的5个请求/秒，具有自动节流和重试逻辑。

错误处理

• 429自动重试（速率限制）
• 清除错误消息
• 优雅降级

国家保护

关键特征： 更新路线时，我们会自动：

1. 获取现有路线
2. 提取停止ID
3. 在更新中保留它们
4. 防止数据丢失

这是一个 最佳实践 这可以防止丢失到达/离开时间。

______________________________________________________________________

📚 文档

环境变量

工具命名约定

所有工具都以前缀 samsara_ 为清楚起见：

• samsara_list_vehicles
• samsara_create_route
• samsara_get_driver_hos
• 等等

______________________________________________________________________

🤝 TMS集成

使用 externalIds 在路线/车辆/驾驶员中与您的TMS链接：

{
  "externalIds": {
    "tmsOrderId": "ORD-12345",
    "customerId": "CUST-789"
  }
}

然后按外部ID查询：

Find the route linked to TMS order ORD-12345

______________________________________________________________________

🐛 故障排除

“错误：需要SAMSARA_API_TOKEN环境变量”

在Claude配置文件中设置API令牌（请参阅上面的配置）。

“Samsara API错误（401）：未经授权”

您的API令牌无效或已过期。在Samsara仪表板中生成一个新的。

“Samsara API错误（429）：请求太多”

MCP将自动重试。如果你经常看到这种情况，你可能会有其他集成击中API。

工具未在Claude中显示

1. 检查配置文件语法（有效的JSON）
2. 完全重新启动Claude（退出并重新打开）
3. 检查Claude日志是否有错误

______________________________________________________________________

📦 包含内容

mcp-samsara/
├── src/
│   └── index.ts          # Main MCP server (2000+ lines)
├── build/                # Compiled JavaScript
├── package.json          # NPM package config
├── tsconfig.json         # TypeScript config
├── README.md            # This file
└── LICENSE              # MIT License

______________________________________________________________________

🔐 安全

• 您的凭据将保留在本地 -API令牌存储在您的计算机上
• 无数据收集 -我们看不到你的轮回数据
• 开源 -自己检查代码
• 家里没有电话 -MCP完全在本地运行

______________________________________________________________________

📈 路线图

• \[\]添加更多工具（调度、资产、标签）
• \[\]支持批量操作
• \[\]增强的优化算法
• \[\]多路径优化
• \[\]燃料成本计算
• \[\]合规报告工具

______________________________________________________________________

🎓 了解更多

• Samsara API文档
• MCP协议规范
• 自动化小队网站

______________________________________________________________________

💬 支持

Beta用户：

• 加入我们 不和谐社区
• 电子邮件：support@automationsquad.com
• GitHub问题： 报告错误

______________________________________________________________________

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件

______________________________________________________________________

🙏 学分

建于❤️ 通过 自动化小队

不隶属于Samsara股份有限公司。 这是一个使用Samsara公共API的独立集成。

______________________________________________________________________

⭐ Beta定价

🚀 测试期间免费！

在我们推出时获得终身75%的折扣：

• Beta用户：每月7.25美元（通常为29美元）
• 前1000名用户： 永远自由

加入Beta等待名单→

______________________________________________________________________

准备好实现车队管理自动化了吗？走吧！ 🚀